LaCroix Water APIlacroixwater.com ↗
Access all LaCroix sparkling water flavors, detailed flavor data, and shop merchandise via a simple REST API. Includes pricing, stock status, and product images.
What is the LaCroix Water API?
The LaCroix Water API exposes 3 endpoints covering every sparkling water flavor and shop merchandise product on lacroixwater.com. Call get_flavors to retrieve the full flavor catalog with SKUs, pricing, stock status, and CDN image URLs, or use get_flavor_detail to pull hex and RGB color values, ISO timestamps, and full descriptions for any single flavor by its URL slug.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/7a8c4c6e-ea61-47c4-b593-d61de79aed64/get_flavors' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lacroixwater-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.lacroix_water_flavors_api import LaCroix, ProductCategory
lacroix = LaCroix()
# List all flavors and print summary info
for flavor in lacroix.flavors.list():
print(flavor.title, flavor.slug, flavor.stock_status, flavor.flavor_color)
# Get detailed info for a specific flavor
lime = lacroix.flavors.get(slug="lime")
print(lime.title, lime.magento_title, lime.created_at, lime.updated_at)
# Refresh a flavor from the list to get full detail
refreshed = flavor.refresh()
print(refreshed.title, refreshed.magento_title)
# List shop products filtered by category
for product in lacroix.products.list(category=ProductCategory.CLOTHING):
print(product.title, product.slug, product.category, product.stock_status)
Returns all available LaCroix sparkling water flavors ordered by display rank. Each flavor includes title, slug, description, SKU, pricing, stock status, color, and product image URL. Single-page response with no pagination parameters.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total number of flavors",
"flavors": "array of flavor objects"
},
"sample": {
"data": {
"total": 23,
"flavors": [
{
"sku": "012993401238",
"slug": "pineapple-coconut",
"price": {
"value": 26,
"currency": "USD"
},
"title": "Pineapple Coconut",
"image_url": "https://cdn.sanity.io/images/hvp4ig31/production/746f6d269252a928480cd6ae8a3792e74e7f60c7-660x1260.png",
"description": "Pineapple Coconut brings a bright pineapple sparkle with a smooth coconut finish.",
"flavor_color": "#fff081",
"product_type": "SimpleProduct",
"stock_status": "IN_STOCK",
"emoji_description": "Pineapple Coconut brings a bright pineapple sparkle... 🍍🥥"
}
]
},
"status": "success"
}
}About the LaCroix Water API
Flavor Catalog and Detail
get_flavors returns the complete LaCroix sparkling water lineup ordered by display rank, with no pagination parameters — the full catalog arrives in a single response. Each flavor object includes a title, slug, sku, description, price (integer value plus currency string), stock_status, and an image_url pointing to the CDN-hosted product photo. The total field at the top level tells you how many flavors are in the response.
get_flavor_detail accepts a single required slug parameter (for example, pamplemousse, lime, or black-razzberry) and returns the full detail record for that flavor. Beyond the fields in the list endpoint, it adds a flavor_color object with a hex string and an rgb sub-object (r, g, b integers), created_at and updated_at ISO timestamps, and the Magento product_type string. If the slug doesn't match any flavor, the endpoint returns an input_not_found error rather than an empty result.
Shop Merchandise
get_shop_products covers the LaCroix branded merchandise store — clothing, accessories, and collectibles — in a single flat response ordered by display rank. Each product object carries title, slug, category, sku, product_type, stock_status, price, image_url, and a variants array for products that come in multiple options (sizes, colors, etc.). The optional category parameter accepts clothing, accessories, or collectibles; omitting it returns all categories together. Like the flavor endpoints, there are no pagination parameters.
Data Shape Notes
Pricing across all three endpoints uses the same structure: an object with a numeric value field and a currency string. Stock status is returned as a string field rather than a boolean. Flavor color data (hex and RGB) is only available through get_flavor_detail, not through the list endpoint — if you need colors for the full catalog you will need to call the detail endpoint per slug.
The LaCroix Water API is a managed, monitored endpoint for lacroixwater.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lacroixwater.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 lacroixwater.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 flavor picker UI that displays product images and stock status from get_flavors.
- Match LaCroix can colors to brand palettes using hex and RGB values from get_flavor_detail.
- Track price changes across the full flavor lineup by polling get_flavors and comparing price.value.
- Filter the merchandise catalog by category (clothing, accessories, collectibles) using get_shop_products.
- Check variant availability for merch products before linking to the LaCroix shop.
- Audit which flavors are currently in stock vs. out of stock using the stock_status field.
- Map SKUs from get_flavors to internal product databases for comparison or enrichment.
| 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 LaCroix offer an official developer API?+
How do I get color data for all flavors at once?+
flavor_color object (hex and RGB values) is only returned by get_flavor_detail, not by get_flavors. To get colors for the full catalog you need to call get_flavor_detail once per slug. The slugs are included in the get_flavors response, so you can iterate over them.Does the API return nutritional information or ingredient lists for flavors?+
Are there pagination parameters for get_flavors or get_shop_products?+
total field in each response tells you how many items were returned.Does the API cover multi-pack or case pricing separately from single-can pricing?+
price object with a value and currency. Variant-level pricing distinctions are not exposed. You can fork the API on Parse and revise it to add a dedicated pricing-variants endpoint if those distinctions matter for your use case.