# Adidas Search API Documentation

<p><strong>Adidas Search API</strong> returns up to 48 products per page: product code, model, name, price, sale price, discount, rating and review count, size labels, color variations, badge, online date, full size images and link. Sort with <code>sort</code> and page with <code>page</code>. The answer carries the total.</p><p>The shop knows models, sports and categories, not free text. A query it does not know answers 422 instead of the whole catalog. Every product is checked against the sale and price filters; products that break a filter are removed and counted in <code>removed_by_filter</code>. A page past the last page is an empty page. A successful request costs 1 credit.</p>

- **Documentation:** [https://scrappa.co/docs/adidas-api/adidas_search](https://scrappa.co/docs/adidas-api/adidas_search)
- **API group:** Adidas API
- **Endpoint:** `GET https://scrappa.co/api/adidas/search`

## 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 |
| --- | --- | --- | --- |
| `query` | string | No | Model, sport or category slug such as samba, ultraboost, running-shoes, men-hoodies or women-clothing. Send query or category. |
| `category` | string | No | Same as query, for a category slug such as men-shoes. Send query or category, not both. |
| `gender` | string | No | men, women, kids or unisex. |
| `size` | string | No | Size label, for example 10, 10.5 or M. |
| `color` | string | No | white, black, blue, brown, green, beige, pink, purple, silver, grey, multi, burgundy, red, yellow, gold or orange. |
| `price_min` | number | No | Lowest current price in USD. |
| `price_max` | number | No | Highest current price in USD. |
| `sale_only` | boolean | No | true returns only products with a sale price. |
| `sort` | string | No | relevance (default), newest, price_asc, price_desc or top_sellers. |
| `page` | integer | No | One-based page number, 1 to 100 (default 1). A page has up to 48 products. |
| `country` | string | No | Country: us (default, the only one). |

## Example response

```json
{
    "data": {
        "page": 1,
        "sort": "price_asc",
        "items": [
            {
                "url": "https://www.adidas.com/us/samba-shoes-kids/JI2757.html",
                "name": "Samba Shoes Kids",
                "badge": null,
                "price": {
                    "amount": 40,
                    "currency": "USD",
                    "discounted": false,
                    "sale_amount": null,
                    "original_amount": 40,
                    "discount_percent": 0
                },
                "sizes": [
                    "5K",
                    "4K"
                ],
                "sport": "Lifestyle",
                "images": [
                    "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0831985698734b1ca8585384416c20de_9366/samba-shoes-kids.jpg",
                    "https://assets.adidas.com/images/w_2000,f_auto,q_auto/76f9f3be08fd41529320a3ea89687179_9366/samba-shoes-kids.jpg"
                ],
                "rating": {
                    "count": 37,
                    "average": 4.78
                },
                "unisex": true,
                "category": "shoes",
                "division": "Originals",
                "subtitle": "Infant & Toddler Originals",
                "image_url": "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0831985698734b1ca8585384416c20de_9366/samba-shoes-kids.jpg",
                "orderable": true,
                "model_code": "DLR34",
                "online_from": "2024-11-26T00:00:00.000Z",
                "product_code": "JI2757",
                "color_variations": [
                    "JI2758",
                    "JI2757"
                ]
            },
            {
                "url": "https://www.adidas.com/us/samba-shoes-kids/JI2758.html",
                "name": "Samba Shoes Kids",
                "badge": "Best Seller",
                "price": {
                    "amount": 40,
                    "currency": "USD",
                    "discounted": false,
                    "sale_amount": null,
                    "original_amount": 40,
                    "discount_percent": 0
                },
                "sizes": [
                    "5K",
                    "4K"
                ],
                "sport": "Lifestyle",
                "images": [
                    "https://assets.adidas.com/images/w_2000,f_auto,q_auto/cdba0dbda5a2493b8886ef2e2e4a247c_9366/samba-shoes-kids.jpg",
                    "https://assets.adidas.com/images/w_2000,f_auto,q_auto/f64baa749afa402bbe4fff85a72ebe98_9366/samba-shoes-kids.jpg"
                ],
                "rating": {
                    "count": 37,
                    "average": 4.78
                },
                "unisex": true,
                "category": "shoes",
                "division": "Originals",
                "subtitle": "Infant & Toddler Originals",
                "image_url": "https://assets.adidas.com/images/w_2000,f_auto,q_auto/cdba0dbda5a2493b8886ef2e2e4a247c_9366/samba-shoes-kids.jpg",
                "orderable": true,
                "model_code": "DLR34",
                "online_from": "2024-11-28T00:00:00.000Z",
                "product_code": "JI2758",
                "color_variations": [
                    "JI2758",
                    "JI2757"
                ]
            }
        ],
        "query": "samba",
        "total": 218,
        "country": "us",
        "currency": "USD",
        "page_size": 48,
        "total_pages": 5,
        "removed_by_filter": 0
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No product matches the request. 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)