# Darty Product Detail API Documentation

`GET /api/darty/product?handle=<handle>` returns one product with numeric EUR prices, original price, discount, availability, stock status, specs, full-size images and variants. Stock and specs come from the same public product search index that powers search, so both routes agree. Variant availability is aligned with that one stock source. If that index has no exact hit, stock fields and variant availability are `null` and `meta.unavailable_reason` names why. `specs` is an object and is `{}` when there are no published properties. The `product` field and `products[0]` are identical compatibility aliases; both stay in the response. Use a `handle` from search, suggest or the product feed unchanged. A wrong handle answers HTTP 200 with `products: []`, is not billed and is not a block. Rating and review count stay `null` until a public review source exists.

## Credits

A successful request with results costs **1 credit**. Errors, challenges and empty results cost nothing.

- **Documentation:** [https://scrappa.co/docs/darty-api/darty_product](https://scrappa.co/docs/darty-api/darty_product)
- **API group:** Darty API
- **Endpoint:** `GET https://scrappa.co/api/darty/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 |
| --- | --- | --- | --- |
| `handle` | string | Yes | Product handle as returned by the other routes. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/darty/product?handle=tv-lg-oled-55"
```

## Example response

```json
{
    "success": true,
    "site": "darty-pt",
    "handle": "tv-lg-oled-55",
    "product": {
        "id": "12345678",
        "handle": "tv-lg-oled-55",
        "title": "TV OLED 55 pouces",
        "price": 899.99,
        "original_price": 1099.99,
        "discount_percent": 18,
        "currency": "EUR",
        "online_available": true,
        "stock_status": "in_stock",
        "specs": [],
        "image": "https://cdn.shopify.com/s/files/1/example/tv.jpg",
        "images": [],
        "variants": [],
        "source": "shopify+search",
        "rating": null,
        "review_count": null
    },
    "products": [],
    "meta": {
        "endpoint_family": "darty-product",
        "billable": true,
        "attempts": 1,
        "credits_charged": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Parameter Not Available | A parameter has no verified recipe. It is rejected before any lookup (`unsupported_filter`). Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters are rejected, never ignored. Non-billable. |
| 503 | Storefront Unavailable | The storefront could not be reached or answered with a challenge. 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)
