adidas.de APIadidas.de ↗
Search, browse, and retrieve product details from adidas.de. Access pricing, size availability, images, and category data via 4 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/858f06a5-fc5f-4fba-9f8f-7d57338bc118/search_products?sz=2&query=shoes&start=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on adidas.de using keywords and optional filters for gender and size. Returns paginated results with product names, prices, and images.
| Param | Type | Description |
|---|---|---|
| sz | integer | Number of results per page |
| size | string | Filter by size, lowercase (e.g. 'xs', 's', 'm', 'l', 'xl', '2xl', '3xl', '42', '44') |
| query | string | Search keyword (e.g. 'shoes', 'running', 't-shirt') |
| start | integer | Pagination start index |
| gender | string | Filter by gender: 'manner', 'frauen', 'kinder', 'unisex' |
{
"type": "object",
"fields": {
"total": "integer total number of matching products",
"products": "array of product summaries with name, id, price, sale_price, url, img"
},
"sample": {
"data": {
"total": 3762,
"products": [
{
"id": "IF6490",
"img": "https://assets.adidas.com/images/w_383,h_383,f_auto,q_auto,fl_lossy,c_fill,g_auto/08c7c0fc4ae84932864226ad74075e6e_9366/Handball_Spezial_Schuh_Braun_IF6490_00_plp_standard.jpg",
"url": "https://www.adidas.de/handball-spezial-schuh/IF6490.html",
"name": "Handball Spezial Schuh",
"price": 110,
"sale_price": null
}
]
},
"status": "success"
}
}About the adidas.de API
The adidas.de API gives developers structured access to the German Adidas storefront through 4 endpoints covering product search, category browsing, full product details, and real-time stock availability. The get_product_details endpoint returns pricing, size variations, attribute lists, media assets, and USP copy for any product ID retrieved from search or browse results. All endpoints return data in German locale, reflecting the adidas.de regional catalog.
Search and Browse
The search_products endpoint accepts a query string plus optional filters for gender (values: manner, frauen, kinder, unisex) and size (EU sizes like 42, 44 or text sizes like xs, xl). Results are paginated via start and sz parameters. Each item in the returned products array includes a product id, name, price, sale_price, direct url, and a thumbnail img. The total field tells you how many matching products exist, so you can calculate page counts for your own pagination logic.
browse_category works the same way but scopes results to a category slug such as shoes, clothing, or accessories. It accepts the same gender, size, start, and sz filters, and returns the same product summary shape. Use it when you want to enumerate a full category rather than run a keyword search.
Product Details and Availability
get_product_details takes a product_id (e.g. IF6490) and returns a detailed record. The attribute_list object holds structured metadata including color, sport type, material, and gender. The variation_list maps each available size to a sku and gtin. The view_list contains image and video URLs with metadata. Pricing comes back in pricing_information as currentPrice, standard_price, and standard_price_no_vat, so you can derive VAT amounts directly. The product_description object includes a title, descriptive text, subtitle, and an array of USPs.
get_product_availability accepts the same product_id and returns current stock status. The response includes an availability_status string and a variation_list breaking down stock per size SKU. This is the endpoint to call when freshness matters — for example, to detect when a previously out-of-stock size becomes available again.
- Track sale prices and standard prices across adidas.de categories to detect discounts in real time using
sale_pricefrom search results. - Build a size-specific product alert system by polling
get_product_availabilityfor target product IDs and specific size SKUs. - Aggregate product attribute data (color, material, sport type) from
attribute_listto power faceted filtering in a third-party storefront. - Monitor stock levels across kids, women, and men categories by combining
browse_categorywith gender filters andget_product_availability. - Extract GTIN values from
variation_listinget_product_detailsto cross-reference products with other retail databases. - Compile a media asset library by pulling
view_listimage and video URLs for use in product comparison or lookbook tools. - Analyze category depth and breadth by iterating
browse_categorywith thetotalfield to measure how many SKUs exist per category.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does adidas have an official public developer API?+
What does `get_product_details` return that search results don't include?+
search_products and browse_category return summary fields: name, id, price, sale_price, url, and img. get_product_details adds the full attribute_list (color, material, sport, gender), the complete variation_list with per-size sku and gtin, all media in view_list, VAT-split pricing in pricing_information, and structured marketing copy in product_description. You need the product ID from a search or browse call to use it.What gender filter values are accepted, and what do they map to?+
gender parameter uses German-language values: manner (men), frauen (women), kinder (children), and unisex. These apply to both search_products and browse_category. Passing any other value will likely return unfiltered or empty results.