--- title: "adidas API: JSON data, 2 endpoints, 1 credit per call" description: "adidas API for US product search by gender, colour, size and price, and product details with optional per-size stock as JSON, from 1 credit per call." url: https://perceptlayer.com/apis/adidas --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / adidas 1 credit per call 2 endpoints 18 datapoints # adidas API adidas API for US product search by gender, colour, size and price, and product details with optional per-size stock as JSON, from 1 credit per call. [Get a free API key](https://perceptlayer.com/signup) Run it below adidas GET /v1/adidas/search?query=samba&gender=men&sort=price\_asc ``` { "success": true, "data": { "query": "samba", "country": "us", "currency": "USD", "page": 1, "page_size": 48, "sort": "price_asc", "total": 52, "total_pages": 2, "removed_by_filter": 0, "items": [ { "product_code": "IH6829", "model_code": "SAMBAU2312", "name": "Samba OG Shoes", "subtitle": "Originals", "division": "Originals", "category": "shoes", "sport": "Soccer", "unisex": true, "price": { "currency": "USD", "amount": 55, "original_amount": 110, "sale_amount": 55, "discounted": true, "discount_percent": 50 }, "rating": { "average": 4.82, "count": 3967 }, "sizes": [ "M 4.5 / W 5.5", "M 4 / W 5" ], "color_variations": [ "IH6816", "KK2280", "KK2278" ], "badge": "Best Seller", "orderable": true, "online_from": "2025-11-05T23:59:00.000Z", "url": "https://www.adidas.com/us/samba-og-shoes/IH6829.html", "image_url": "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0337473ad2544a53b4def3374906d5b2_9366/samba-og-shoes.jpg", "images": [ "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0337473ad2544a53b4def3374906d5b2_9366/samba-og-shoes.jpg", "https://assets.adidas.com/images/w_2000,f_auto,q_auto/c4c7e4f172af48e4b49153519f7bca7f_9366/samba-og-shoes.jpg", "https://assets.adidas.com/images/w_2000,f_auto,q_auto/8d647bfd45a84790a82128e09093f385_9366/samba-og-shoes.jpg" ] }, { "product_code": "HQ9248", "model_code": "OOZ21", "name": "SAMBA LT SHOES", "subtitle": "Originals", "division": "Originals", "category": "shoes", "sport": "Lifestyle", "unisex": true, "price": { "currency": "USD", "amount": 65, "original_amount": 130, "sale_amount": 65, "discounted": true, "discount_percent": 50 }, "rating": { "average": 4.7, "count": 82 }, "sizes": [ "M 6 / W 7", "M 5 / W 6", "M 4.5 / W 5.5" ], "orderable": true, "online_from": "2026-02-03T00:00:00.000Z", "url": "https://www.adidas.com/us/samba-lt-shoes/HQ9248.html", "image_url": "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0e802cba4ae24147b6e0743ea3165740_9366/samba-lt-shoes.jpg", "images": [ "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0e802cba4ae24147b6e0743ea3165740_9366/samba-lt-shoes.jpg", "https://assets.adidas.com/images/w_2000,f_auto,q_auto/4f2bf1d4cfef4ddba2c5680b2d71fba9_9366/samba-lt-shoes.jpg", "https://assets.adidas.com/images/w_2000,f_auto,q_auto/4b2f8abe0d71436cab5010c09caeed5a_9366/samba-lt-shoes.jpg" ] }, { "product_code": "KH6893", "model_code": "OQZ80", "name": "ADIDAS X COCA-COLA SAMBA OG SHOES", "subtitle": "Originals", "division": "Originals", "category": "shoes", "sport": "Lifestyle", "unisex": true, "price": { "currency": "USD", "amount": 65, "original_amount": 130, "sale_amount": 65, "discounted": true, "discount_percent": 50 }, "rating": { "average": 4.89, "count": 410 }, "sizes": [ "M 14 / W 15", "M 10.5 / W 11.5", "M 13 / W 14" ], "orderable": true, "online_from": "2026-05-28T01:00:00.000Z", "url": "https://www.adidas.com/us/adidas-x-coca-cola-samba-og-shoes/KH6893.html", "image_url": "https://assets.adidas.com/images/w_2000,f_auto,q_auto/222561f2400b4c0c8ed43c1ca37de763_9366/adidas-x-coca-cola-samba-og-shoes.jpg", "images": [ "https://assets.adidas.com/images/w_2000,f_auto,q_auto/222561f2400b4c0c8ed43c1ca37de763_9366/adidas-x-coca-cola-samba-og-shoes.jpg", "https://assets.adidas.com/images/w_2000,f_auto,q_auto/b078448314034059a4d609f559c94060_9366/adidas-x-coca-cola-samba-og-shoes.jpg", "https://assets.adidas.com/images/w_2000,f_auto,q_auto/aca94dde0e934b8885b5a5b43431c861_9366/adidas-x-coca-cola-samba-og-shoes.jpg" ] } ] }, "meta": { "endpoint_family": "search", "request_id": "req_f2b52b8440ce4bd5a7be236c75419cdb", "credits_charged": 1, "credits_remaining": 1997 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | product\_code string | model\_code string | name string | subtitle string | division string | category string | sport string | unisex boolean | price object | rating object | sizes string\[\] | color\_variations string\[\] | badge string | orderable boolean | online\_from string | url url | image\_url url | images string\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | IH6829 | SAMBAU2312 | Samba OG Shoes | Originals | Originals | shoes | Soccer | true | {6 fields} | {2 fields} | \[2 items\] | \[3 items\] | Best Seller | true | 2025-11-05T23:59:00.000Z | https://www.adidas.com/us/samba-og-shoes/IH6829.html | https://assets.adidas.com/images/w\_2000,f\_auto,q\_auto/0337473ad2544a53b4def3374906d5b2\_9366/samba-og-shoes.jpg | \[3 items\] | | 2 | HQ9248 | OOZ21 | SAMBA LT SHOES | Originals | Originals | shoes | Lifestyle | true | {6 fields} | {2 fields} | \[3 items\] | — | — | true | 2026-02-03T00:00:00.000Z | https://www.adidas.com/us/samba-lt-shoes/HQ9248.html | https://assets.adidas.com/images/w\_2000,f\_auto,q\_auto/0e802cba4ae24147b6e0743ea3165740\_9366/samba-lt-shoes.jpg | \[3 items\] | | 3 | KH6893 | OQZ80 | ADIDAS X COCA-COLA SAMBA OG SHOES | Originals | Originals | shoes | Lifestyle | true | {6 fields} | {2 fields} | \[3 items\] | — | — | true | 2026-05-28T01:00:00.000Z | https://www.adidas.com/us/adidas-x-coca-cola-samba-og-shoes/KH6893.html | https://assets.adidas.com/images/w\_2000,f\_auto,q\_auto/222561f2400b4c0c8ed43c1ca37de763\_9366/adidas-x-coca-cola-samba-og-shoes.jpg | \[3 items\] | Recorded from our API · 3 items shown · 18 datapoints per item GET /v1/adidas/search?query=samba&gender=men&sort=price\_asc 18 datapoints ### Identity - name string - subtitle string - category string ### Contact - url url - image\_url url ### Reputation - rating object - badge string - images string\[\] ### Price - price object ### Other - product\_code string - model\_code string - division string - sport string - unisex boolean - sizes string\[\] - color\_variations string\[\] - orderable boolean - online\_from string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/adidas/search?query=samba&gender=men&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` adidas · 2 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/adidas/product`](https://perceptlayer.com/apis/adidas/product) | none +4 optional | 1–10 credits | | [GET `/v1/adidas/search`](https://perceptlayer.com/apis/adidas/search) | none +11 optional | 1 credit | Overview ## About the adidas API ## What you can get The adidas API returns adidas US shop data as JSON through 2 endpoints. Both take a `country` of us. - **Search:** `search` takes a `query` or a `category`, with `gender` (men, women, kids or unisex), `size`, `color` (white, black, blue, brown, green, beige, pink, purple, silver, grey, multi, burgundy, red, yellow, gold or orange), `price_min`, `price_max`, `sale_only`, `sort` (relevance, newest, price\_asc, price\_desc or top\_sellers) and `page`. - **Products:** `product` takes a `product_code` or a product `url`, with `include_stock` for per-size stock. The recorded search for "samba", for men, sorted by price\_asc, returns `items`, each with `product_code`, `model_code`, `name`, `subtitle`, `division`, `category`, `sport`, `price` ( `amount`, `original_amount`, `sale_amount`, `discounted` and `discount_percent`), `rating` ( `average` and `count`), `sizes`, `color_variations`, `badge`, `orderable`, `online_from`, `url` and `images`. It also returns `total` (52 in that recording) and `total_pages`. ## How a call works Search, then look up: `GET /v1/adidas/search?query=samba&gender=men&sort=price_asc` with your key in the `X-API-Key` header. Each result carries a `product_code`; `GET /v1/adidas/product?product_code=JQ9082&include_stock=false` returns that product for 1 credit. `product` includes per-size stock unless you set `include_stock=false`, and with stock it costs 10 credits. `search` costs 1 credit per successful call; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) [Depop](https://perceptlayer.com/apis/depop) Use cases ### Track adidas prices and discounts for a list of product codes `Use the adidas API to track adidas prices and discounts for a list of product codes` ### Check per-size stock for a product before a release or restock `Use the adidas API to check per-size stock for a product before a release or restock` ### Watch sale items for a gender and colour `Use the adidas API to watch sale items for a gender and colour` ### Follow new products with \`sort=newest\` `` Use the adidas API to follow new products with `sort=newest` `` FAQ ## Questions **How much does the adidas API cost?** A successful \`search\` call costs one credit. A successful \`product\` call costs ten credits with per-size stock, which is on by default, and one credit with \`include\_stock=false\`. New accounts get free credits to start, and credit packs bring the price down as you scale. **How do I keep product calls at 1 credit?** Pass \`include\_stock=false\` to \`product\`. You get the product without per-size stock, for one credit. **Do I need an adidas account?** No. You call this adidas API with your Perceptlayer key in the \`X-API-Key\` header, with no adidas login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build an adidas scraper instead?** You can, but an adidas scraper is code you maintain: page changes break it, requests get blocked, and adidas's terms govern how you collect data. The adidas API gives you 2 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the adidas API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)