Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / adidas

1 credit per call2 endpoints18 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 keyRun 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 OKJSONX-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_codestringmodel_codestringnamestringsubtitlestringdivisionstringcategorystringsportstringunisexbooleanpriceobjectratingobjectsizesstring[]color_variationsstring[]badgestringorderablebooleanonline_fromstringurlurlimage_urlurlimagesstring[]
1IH6829SAMBAU2312Samba OG ShoesOriginalsOriginalsshoesSoccertrue{6 fields}{2 fields}[2 items][3 items]Best Sellertrue2025-11-05T23:59:00.000Zhttps://www.adidas.com/us/samba-og-shoes/IH6829.htmlhttps://assets.adidas.com/images/w_2000,f_auto,q_auto/0337473ad2544a53b4def3374906d5b2_9366/samba-og-shoes.jpg[3 items]
2HQ9248OOZ21SAMBA LT SHOESOriginalsOriginalsshoesLifestyletrue{6 fields}{2 fields}[3 items]——true2026-02-03T00:00:00.000Zhttps://www.adidas.com/us/samba-lt-shoes/HQ9248.htmlhttps://assets.adidas.com/images/w_2000,f_auto,q_auto/0e802cba4ae24147b6e0743ea3165740_9366/samba-lt-shoes.jpg[3 items]
3KH6893OQZ80ADIDAS X COCA-COLA SAMBA OG SHOESOriginalsOriginalsshoesLifestyletrue{6 fields}{2 fields}[3 items]——true2026-05-28T01:00:00.000Zhttps://www.adidas.com/us/adidas-x-coca-cola-samba-og-shoes/KH6893.htmlhttps://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 itemGET /v1/adidas/search?query=samba&gender=men&sort=price_asc

18 datapoints

Identity

  • namestring
  • subtitlestring
  • categorystring

Contact

  • urlurl
  • image_urlurl

Reputation

  • ratingobject
  • badgestring
  • imagesstring[]

Price

  • priceobject

Other

  • product_codestring
  • model_codestring
  • divisionstring
  • sportstring
  • unisexboolean
  • sizesstring[]
  • color_variationsstring[]
  • orderableboolean
  • online_fromstring

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/adidas/product
none+4 optional
1–10 credits
GET/v1/adidas/search
none+11 optional
1 credit

Overview

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.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBADepop

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 keyRead the docs