# Flaconi Product API Documentation

<p><strong>Flaconi Product API</strong> 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.</p><p><strong>Cost:</strong> 1 credit per request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/flaconi-api/flaconi_product](https://scrappa.co/docs/flaconi-api/flaconi_product)
- **API group:** Flaconi API
- **Endpoint:** `GET https://scrappa.co/api/flaconi/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Optional variant id from search, suggest or category, for example 80041833-30. Omit when using an id from ids. |
| `slug` | string | Yes | Full product path from the url of a search, category or ids row, without .html. A trailing .html is accepted. |
| `locale` | string | No | Storefront locale, de-DE (default). |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
|  | Error | The id or slug is unknown. Not billed. |
|  | Error | Flaconi could not be reached. Not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
