# ABOUT YOU Product API Documentation

<p><strong>ABOUT YOU Product API</strong> returns one product by id or product link: name, brand, color, price with original price and discount, every size with stock, SKU and price, color variants, images in full size, badges, category path, article number, materials and care, manufacturer, shipping and return text. Prices are numbers with currency. The reference price line of the shop is returned as text and amount.</p><p>Stock is the number the shop reports for a size. A size without stock is not available. Ratings and review counts are not shown without a login and are not returned.</p><p>A product that is not sold in the chosen shop answers 404. Pick the product id from the Search route of the same shop.</p><p><strong>Credits:</strong> 1 credit per successful request. Failed requests and empty answers are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/about-you-api/about_you_product](https://scrappa.co/docs/about-you-api/about_you_product)
- **API group:** ABOUT YOU API
- **Endpoint:** `GET https://scrappa.co/api/about-you/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 |
| --- | --- | --- | --- |
| `product_id` | integer | No | ABOUT YOU product id, the number at the end of a product link. Send product_id or url. |
| `url` | string | No | Product link of any ABOUT YOU shop. It must end in the product id. Send url or product_id. |
| `country` | string | No | Shop: de (default), ch, at, nl, be, pl, cz, sk, ro, hu, fr or lu. Product ids and categories can differ per shop. |
| `language` | string | No | Optional. ch takes de (default) or fr. be takes fr (default) or nl. Other shops have one language. |

## Example response

```json
{
    "data": {
        "id": 14930072,
        "url": "https://www.aboutyou.de/p/adidas-originals/sneaker-handball-spezial-14930072",
        "name": "Sneaker 'Handball Spezial'",
        "brand": {
            "id": 290,
            "url": "https://www.aboutyou.de/b/shop/adidas-originals-290",
            "name": "ADIDAS ORIGINALS"
        },
        "color": "Schoko",
        "image": "https://cdn.aboutstatic.com/file/images/a5e74f910d0c0da1d094393124e8ae5c.jpg?brightness=0.96&trim=1",
        "price": {
            "net": 91.6,
            "current": 109,
            "currency": "EUR",
            "original": null,
            "discount_amount": null,
            "discount_percent": null,
            "price_with_coupon": null
        },
        "badges": [
            "Unisex"
        ],
        "images": [
            "https://cdn.aboutstatic.com/file/images/a5e74f910d0c0da1d094393124e8ae5c.jpg?brightness=0.96&trim=1",
            "https://cdn.aboutstatic.com/file/images/cd6abb9e7bc672bf1168aa2407f389aa.jpg",
            "https://cdn.aboutstatic.com/file/images/f3f9aa9d400020f6ee7f6abb9f35d245.jpg"
        ],
        "country": "de",
        "on_sale": false,
        "sold_by": "Verkauft & Versandt von ABOUT YOU",
        "in_stock": true,
        "language": "de",
        "sections": [
            {
                "items": [
                    "Logoprint",
                    "Leder",
                    "Runde Kappe"
                ],
                "title": "Design & Extras"
            },
            {
                "items": [
                    "Absatzh\u00f6he: Flacher Absatz (0-3 cm)"
                ],
                "title": "Gr\u00f6\u00dfe & Fit"
            },
            {
                "items": [
                    "Obermaterial:  Leder",
                    "Futter und Decksohle:  Textil",
                    "Laufsohle:  Gummi"
                ],
                "title": "Material & Pflege"
            },
            {
                "items": [
                    "Sneaker-Stil: Casual"
                ],
                "title": "Funktionalit\u00e4t"
            }
        ],
        "shipping": {
            "note": "Kostenloser Versand & R\u00fcckversand",
            "return_policy": "30 Tage R\u00fcckgaberecht",
            "delivery_estimate": "Ab 2 - 3 Werktage"
        },
        "variants": [
            {
                "id": 64040108,
                "sku": "Ado9a7c001000001",
                "size": "35,5",
                "price": {
                    "amount": 109,
                    "currency": "EUR",
                    "tax_part": 17.4
                },
                "stock": 28,
                "size_us": "3",
                "available": true,
                "low_stock_hint": null,
                "price_reference": {
                    "label": "Letzter niedrigster Preis",
                    "amount": 109
                }
            },
            {
                "id": 64040109,
                "sku": "Ado9a7c001000002",
                "size": "36",
                "price": {
                    "amount": 109,
                    "currency": "EUR",
                    "tax_part": 17.4
                },
                "stock": 90,
                "size_us": "3,5",
                "available": true,
                "low_stock_hint": null,
                "price_reference": {
                    "label": "Letzter niedrigster Preis",
                    "amount": 109
                }
            },
            {
                "id": 64040110,
                "sku": "Ado9a7c001000003",
                "size": "36,5-37",
                "price": {
                    "amount": 109,
                    "currency": "EUR",
                    "tax_part": 17.4
                },
                "stock": 153,
                "size_us": "4",
                "available": true,
                "low_stock_hint": null,
                "price_reference": {
                    "label": "Letzter niedrigster Preis",
                    "amount": 109
                }
            }
        ],
        "materials": [
            "Obermaterial:  Leder",
            "Futter und Decksohle:  Textil",
            "Laufsohle:  Gummi",
            "Enth\u00e4lt nichttextile Teile tierischen Ursprungs: ja",
            "Ursprungsland: Vietnam"
        ],
        "manufacturer": {
            "name": "adidas BV (Amsterdam)",
            "address": "Hoogoorddreef 9-A, 1101 BA Amsterdam, NL",
            "contact": "www.adidas.com"
        },
        "category_path": [
            {
                "id": 20201,
                "url": "https://www.aboutyou.de/c/frauen-20201",
                "name": "Frauen"
            },
            {
                "id": 20207,
                "url": "https://www.aboutyou.de/c/frauen/schuhe-20207",
                "name": "Schuhe"
            },
            {
                "id": 20273,
                "url": "https://www.aboutyou.de/c/frauen/schuhe/sneaker-20273",
                "name": "Sneaker"
            },
            {
                "id": 20727,
                "url": "https://www.aboutyou.de/c/frauen/schuhe/sneaker/sneaker-low-20727",
                "name": "Sneaker Low"
            },
            {
                "id": 235446,
                "url": "https://www.aboutyou.de/c/frauen/schuhe/sneaker/sneaker-low/casual-sneaker-235446",
                "name": "ADIDAS ORIGINALS Casual Sneaker"
            }
        ],
        "article_number": "Ado9a7c001000001",
        "color_variants": [
            {
                "url": "https://www.aboutyou.de/p/adidas-originals/sneaker-handball-spezial-14930072",
                "color": "Schoko",
                "image": "https://cdn.aboutstatic.com/file/images/a5e74f910d0c0da1d094393124e8ae5c.jpg?brightness=0.96&trim=1",
                "current": true,
                "product_id": 14930072
            },
            {
                "url": "https://www.aboutyou.de/p/adidas-originals/sneaker-handball-spezial-17684689",
                "color": "Silber",
                "image": "https://cdn.aboutstatic.com/file/images/cfb6a18d7a0225d4688ca6524a0c8937.png?bg=F4F4F5&trim=1",
                "current": false,
                "product_id": 17684689
            }
        ],
        "price_reference": {
            "label": "Letzter niedrigster Preis",
            "amount": 109
        },
        "short_description": "Logoprint, Leder, Runde Kappe, 7-Loch-Schn\u00fcrung, Profilsohle"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The product does not exist in this shop. This response is not billable. |
| 503 | Upstream Unavailable | ABOUT YOU could not be reached. Retry shortly. This response is not billable. |

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