Skip to content
Scrappa Get API key
Flaconi API 1 credit / request

Flaconi Product API Documentation

GET https://scrappa.co/api/flaconi/product

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.

Flaconi Product API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/flaconi/product
Auth header
x-api-key
Cost
1 credit / request
slug = example
Response preview
200 OK
{
    "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
...

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.

slug string Required

Full product path from the url of a search, category or ids row, without .html. A trailing .html is accepted.

Example value example
id string Optional

Optional variant id from search, suggest or category, for example 80041833-30. Omit when using an id from ids.

Example value 1234567890
locale string Optional

Storefront locale, de-DE (default).

Example value 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
JSON Response
200 OK
{
    "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.

NOT_FOUND

HTTP NOT_FOUND

The id or slug is unknown. Not billed.

UPSTREAM_UNAVAILABLE

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.