Adidas Search API 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 sort and page with page. The answer carries the total.
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 removed_by_filter. A page past the last page is an empty page. A successful request costs 1 credit.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
11 optional filters available.
string
Optional
Model, sport or category slug such as samba, ultraboost, running-shoes, men-hoodies or women-clothing. Send query or category.
coffee shops
string
Optional
Same as query, for a category slug such as men-shoes. Send query or category, not both.
example
string
Optional
men, women, kids or unisex.
example
string
Optional
Size label, for example 10, 10.5 or M.
example
string
Optional
white, black, blue, brown, green, beige, pink, purple, silver, grey, multi, burgundy, red, yellow, gold or orange.
example
number
Optional
Lowest current price in USD.
10
number
Optional
Highest current price in USD.
10
boolean
Optional
true returns only products with a sale price.
true
string
Optional
relevance (default), newest, price_asc, price_desc or top_sellers.
relevance
integer
Optional
One-based page number, 1 to 100 (default 1). A page has up to 48 products.
1
string
Optional
Country: us (default, the only one).
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Not Found
No product matches the request. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "search"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"query": [
"Send a query or a category."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Adidas could not be reached, or it returned data that does not match the request. This response is not billable. Retry shortly.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Adidas could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.