drinkhint APIdrinkhint.com ↗
Access Hint Water product catalog data via API. Search products, retrieve full details, and list collections including still, sparkling, and variety packs.
What is the drinkhint 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'.
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 API
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.
The drinkhint API is a managed, monitored endpoint for drinkhint.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when drinkhint.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official drinkhint.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.