# Adidas Product API Documentation

<p><strong>Adidas Product API</strong> returns one product by code or URL: name, brand, category, color, price, sale price, discount, rating and review count, full size images and link.</p><p>With <code>include_stock=true</code> (default) the answer adds description, highlights, materials, breadcrumb, colorways and every size with SKU, GTIN, a stock count and a status. The stock count stops at 15, so <code>stock_capped</code> marks a size with 15 or more. This lookup runs in a browser and takes 2 to 35 seconds. It costs 10 credits.</p><p>With <code>include_stock=false</code> the answer has size labels and <code>stock: null</code> and costs 1 credit. An unknown code answers 404. Failures are never billed.</p>

- **Documentation:** [https://scrappa.co/docs/adidas-api/adidas_product](https://scrappa.co/docs/adidas-api/adidas_product)
- **API group:** Adidas API
- **Endpoint:** `GET https://scrappa.co/api/adidas/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_code` | string | No | Product code, for example JQ9082. Send product_code or url. |
| `url` | string | No | Full Adidas product page URL (or send product_code). |
| `include_stock` | boolean | No | true (default) adds description, materials, every size with SKU, GTIN and stock, and colorways. Costs 10 credits. false returns the price data for 1 credit, with stock null. |
| `country` | string | No | Country: us (default, the only one). |

## Example response

```json
{
    "data": {
        "url": "https://www.adidas.com/us/ultraboost-5x-shoes/JQ9082.html",
        "name": "Ultraboost 5x Shoes",
        "badge": null,
        "brand": "Performance",
        "color": "Core Black / Silver Metallic / Lucid Orange",
        "price": {
            "amount": 90,
            "currency": "USD",
            "discounted": true,
            "sale_amount": 90,
            "original_amount": 180,
            "discount_percent": 50
        },
        "sizes": [],
        "stock": {
            "cap": 15,
            "note": "Stock per size is a count capped at 15, with a status.",
            "source": "live"
        },
        "gender": "men",
        "images": [
            "https://assets.adidas.com/images/w_2000,f_auto,q_auto/b82b43ad6960480fb28d21f718587fb6_9366/Ultraboost_5x_Shoes_Black_JQ9082_01_00_standard.jpg",
            "https://assets.adidas.com/images/w_2000,f_auto,q_auto/592bf9d194df4588808eb8d4e28cbe9c_9366/Ultraboost_5x_Shoes_Black_JQ9082_01_03_hover_standard.jpg"
        ],
        "rating": {
            "count": 1816,
            "average": 4.63
        },
        "sports": [
            "Running"
        ],
        "country": "us",
        "on_sale": true,
        "category": "Shoes",
        "colorways": [
            {
                "url": "https://www.adidas.com/us/ultraboost-5x-shoes/IH4005.html",
                "name": "ULTRABOOST 5X Shoes",
                "color": "White",
                "price": {
                    "amount": 135,
                    "currency": "USD",
                    "discounted": true,
                    "sale_amount": 135,
                    "original_amount": 180,
                    "discount_percent": 25
                },
                "image_url": "https://assets.adidas.com/images/w_2000,f_auto,q_auto/52adc74191dd42f996e0b40c66cd36e7_9366/ULTRABOOST_5X_Shoes_White_IH4005_HM1.jpg",
                "product_code": "IH4005"
            }
        ],
        "materials": {
            "Upper": "Textile / Other Materials",
            "Lining": "Textile",
            "Outsole": "Other Materials"
        },
        "orderable": true,
        "breadcrumb": [
            "Men",
            "Shoes"
        ],
        "final_sale": false,
        "highlights": [
            "Regular fit",
            "Lace closure"
        ],
        "model_code": "NKQ99",
        "description": "Chasing new PRs feels easier in these adidas running shoes. Our lightest BOOST yet delivers continual energy return across the miles so you feel fresh from start to finish. Add the Torsion System betw",
        "online_from": "2025-12-06T00:00:00.000Z",
        "product_code": "JQ9082",
        "discount_text": "-50%",
        "color_variations": [
            "IH4005",
            "JQ9082"
        ],
        "description_title": "A new generation of BOOST running shoes made in part with recycled materials.",
        "availability_status": "IN_STOCK"
    },
    "meta": {
        "credits": 10,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The product code does not exist. This response is not billable. |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 503 | Upstream Unavailable | Adidas could not be reached, or it returned data that does not match the request. This response is not billable. Retry shortly. |

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