Flaconi Product API returns one product by the variant id and slug from search, category or ids. It includes numeric price, original price, discount, one row per size with its own numeric price, specs, fragrance notes, stock and full-size images. Competitor fields that the source does not publish stay null.
Cost: 1 credit per request. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
string
Required
Full product path from the url of a search, category or ids row, without .html. A trailing .html is accepted.
example
string
Optional
Optional variant id from search, suggest or category, for example 80041833-30. Omit when using an id from ids.
1234567890
string
Optional
Storefront locale, de-DE (default).
en-US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"id": "80041833-30",
"ean": "3348901567572",
"name": "Sauvage Eau de Parfum",
"brand": {
"name": "Dior"
},
"notes": [],
"price": {
"current": 98,
"currency": "EUR",
"original": 120,
"discount_percent": 18.3
},
"specs": [
{
"name": "Duftrichtung",
"value": "Holzig"
}
],
"stock": {
"status": "InStock",
"in_stock": true
},
"images": [
"https://cdn.flaconi.net/media/catalog/product/3/3/3348901567572-1_c_live.jpg"
],
"rating": 4.8,
"variants": [
{
"sku": "80041833-30",
"size": "100 ml",
"price": {
"current": 98,
"currency": "EUR"
},
"in_stock": true
}
],
"low_30_day": null,
"plus_price": null,
"variant_sku": "80041833-30",
"review_count": 1952
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "product"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP NOT_FOUND
The id or slug is unknown. Not billed.
HTTP UPSTREAM_UNAVAILABLE
Flaconi could not be reached. Not billed.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.