drinkhint.com APIwww.drinkhint.com ↗
Access Hint Water product catalog data via API. Search products, retrieve full details, and list collections including still, sparkling, and variety packs.
curl -X GET 'https://api.parse.bot/scraper/46e5e0ea-070b-439b-b073-4d8c53f52830/search_products?limit=5&query=lemon' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Hint water products by keyword. Returns up to 10 matching products with pricing and availability. Uses the site's predictive search and matches against product titles, descriptions, and tags.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return. Capped at 10 by the upstream search API. |
| query | string | Search query text to find products. |
{
"type": "object",
"fields": {
"count": "integer",
"query": "string",
"products": "array of product summaries"
},
"sample": {
"count": 5,
"query": "lemon",
"products": [
{
"id": 7243649515623,
"url": "/products/hint%C2%AE-water-variety-pack-star-spangled?_pos=1&_psq=lemon&_ss=e&_v=1.0",
"image": "https://cdn.shopify.com/s/files/1/0014/3015/9418/files/variety-pack-star-spangled.png?v=1773941740",
"price": "22.99",
"title": "hint® water variety pack - Star Spangled",
"handle": "hint®-water-variety-pack-star-spangled",
"vendor": "hint water",
"available": true,
"price_max": "22.99",
"price_min": "22.99",
"product_type": "16oz bottle"
}
]
}
}About the drinkhint.com API
The drinkhint.com API exposes 3 endpoints covering Hint Water's full product catalog, including search, individual product detail, and collection browsing. The get_product endpoint returns up to 10 response fields per product — including variants, images, tags, and pricing — while list_collection supports paginated access to named collections like 'sparkling-water' and 'variety-packs'.
What the API Covers
This API provides structured access to Hint Water's product catalog at drinkhint.com. It covers three operations: keyword search via search_products, full product detail retrieval via get_product, and paginated collection browsing via list_collection. All three endpoints return product data including titles, handles, variants, and images.
Endpoint Details
search_products accepts a query string and an optional limit (capped at 10). It matches against product titles, descriptions, and tags, and returns a count, the echoed query, and an array of product summaries. Use this to find product handles for follow-up calls.
get_product takes a handle — the URL slug identifying a product, such as watermelon-hint-water — and returns the full product record: id, title, vendor, product_type, body_html description, tags, published_at, an images array with image objects, and a variants array containing pricing and availability data.
list_collection accepts a collection handle (e.g. still-bottles, sparkling-water, variety-packs, bundles, or all), a 1-based page integer, and a limit between 1 and 250. It returns a paginated array of product summaries alongside count, page, limit, and collection fields. Use all to iterate the full catalog.
Source and Freshness
Drinkhint.com does not publish a documented public developer API. Data reflects the live product catalog as listed on the site. Product availability, pricing, and variant options are sourced from the active storefront and reflect what a visitor would see at the time of the request.
- Build a price tracker that monitors Hint Water variant prices across still, sparkling, and can formats using
get_productvariant data. - Populate an affiliate product feed by iterating
list_collectionwith the 'all' collection handle and paginating through the full catalog. - Implement a product search widget that queries
search_productsby flavor keyword and displays matching results with images and pricing. - Generate a flavor availability index by extracting
tagsandproduct_typefields from all products in a collection. - Sync Hint Water SKU and variant data into an internal inventory or e-commerce management system using
variantsarray fields. - Audit product descriptions and metadata by pulling
body_htmlandtagsacross the full catalog vialist_collection. - Compare bundle and variety-pack pricing against individual unit prices using the
variantsfield fromget_product.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does drinkhint.com have an official developer API?+
What does the `get_product` endpoint return, and how do I get the handle?+
id, title, vendor, product_type, body_html, tags, published_at, an images array, and a variants array with pricing and availability. The handle is the URL slug for the product (e.g. watermelon-hint-water) and is available in results from both search_products and list_collection.What collections can I browse with `list_collection`?+
all, still-bottles, still-cans, sparkling-water, variety-packs, and bundles. Use all to paginate the complete catalog. The limit parameter accepts values between 1 and 250 per page.Does the API return customer reviews or ratings for Hint Water products?+
Is search limited to 10 results?+
search_products returns a maximum of 10 products per request, regardless of the limit parameter. To browse more of the catalog, use list_collection with pagination, which supports up to 250 products per page.