# Coolblue Product Details API Documentation

`GET /api/coolblue/product` returns one Coolblue product as structured JSON. Pass the `id` from a search result unchanged, or a product link.

The product carries EUR `price` and struck `original_price`, a short `availability` enum (`in_stock`, `out_of_stock`, `unknown`), a delivery promise, store stock, grouped `specs`, a rating on a 0-10 scale with a star `rating_distribution` read from the published review counts, full-size image URL strings and the breadcrumb. Specs are read from the requested product's payload, with the main product payload on the same page as a safe fallback. Template placeholders and duplicate rows are removed. Fields absent from the same public page stay null and are named in `unavailable_fields`. No second lookup is issued. A slow or unavailable source returns a clean, non-billable error before the request budget ends, never a bare client timeout.

## Credits

A successful request costs **1 credit**. Errors, challenges and empty pages cost nothing. The response shows the charge in `meta.credits_charged`.

- **Documentation:** [https://scrappa.co/docs/coolblue-api/coolblue_product](https://scrappa.co/docs/coolblue-api/coolblue_product)
- **API group:** Coolblue API
- **Endpoint:** `GET https://scrappa.co/api/coolblue/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 |
| --- | --- | --- | --- |
| `market` | string | No | nl (default). Other markets return 422 until they pass their own soak. |
| `id` | string | No | Product id from search results. Use this or url. |
| `url` | string | No | Product link of a supported storefront. Use this or id. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/coolblue/product?id=1234567"
```

## Example response

```json
{
    "success": true,
    "market": "nl",
    "currency": "EUR",
    "product": {
        "id": "1234567",
        "title": "Example Koptelefoon",
        "brand": "ExampleBrand",
        "price": 89.95,
        "original_price": 119,
        "discount_percent": 24,
        "currency": "EUR",
        "availability": "in_stock",
        "online_available": true,
        "delivery": "morgen gratis bezorgd",
        "store_stock": {
            "status": "in_stock"
        },
        "rating": 8.5,
        "review_count": 120,
        "rating_scale": "0-10",
        "rating_distribution": {
            "8": 40
        },
        "specs": {
            "General": [
                {
                    "name": "Kleur",
                    "value": "Zwart"
                }
            ]
        },
        "images": [
            "https://media.coolblue.nl/image.jpg"
        ],
        "breadcrumb": [
            "Audio",
            "Koptelefoons"
        ]
    },
    "unavailable_fields": [],
    "meta": {
        "endpoint_family": "coolblue-product",
        "billable": true,
        "attempts": 1,
        "credits_charged": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Parameter Not Available Yet | `sort`, `page`, `min_price` and `max_price` have no verified public page recipe and return 422 before any lookup (`unsupported_filter`). Unsoaked markets return 422 (`unsupported_market`). Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown, conflicting or unusable. Unknown parameters are rejected, never ignored. Non-billable. |
| 503 | Upstream Unavailable | The storefront could not be reached, answered with a challenge, or changed its page shape (`upstream_blocked`, `upstream_unavailable`, `parser_drift`). Retryable and never billed. Clients are never rate limited. |

## 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)
