Adidas API Documentation

Get an Adidas product

Returns product-detail data for one Adidas SKU: name, brand, category, description, pricing (current/standard/sale), images, and every purchasable size variant. product_id is the Adidas SKU (e.g. JI0397), taken from a search result's products[].id field or the trailing segment of an Adidas product page URL. An unknown product_id returns a not-found error.

Required: product_id.

Open in Playground

Get Adidas review topics for a product

Returns the topics an Adidas product model's customer reviews can be filtered by -- the "filter by topic" chips the product page shows, commonly satisfaction, comfort, color, purchase, fit, appearance, quality and style. Feed a topics[].topic value back to /adidas/product/reviews as its topic parameter to return only reviews about that aspect. The topic vocabulary is per model, not a fixed list: a shoe exposes fit and comfort topics that an accessory does not, so read it per model rather than hard-coding it. model_number is the Adidas model number (e.g. SAMBAU2312) -- NOT the SKU: take it from an adidas_search result's products[].model_number field. A model with no reviews, including a well-formed but unrecognized model_number, returns an empty topics list rather than an error. Note the label field is a display form of topic, not translated text: Adidas returns the same English values for every locale on this route.

Required: model_number. Optional: locale.

Sampled 14 Oct 2026: 10 items. Filled in every item: topic, label.

Open in Playground

Get Adidas product reviews

Returns one page of customer reviews for an Adidas product model, plus the model's rating summary: overall rating, star histogram, percentage of reviewers who recommend it, per-attribute averages (Size, Width, Comfort, Quality with their own scale labels), and Adidas's AI-generated review digest when one exists. Each review carries the rating, headline, body, author nickname, purchased colorway, helpful/not-helpful vote counts, badges, customer photos, and submission time. model_number is the Adidas model number (e.g. SAMBAU2312) -- NOT the SKU: take it from an adidas_search result's products[].model_number field, which is a different value from products[].id. Reviews are returned 10 per page. Reviews are scoped to review text written in the requested locale's language, and most of the US catalog's reviews are English, so a non-English locale commonly returns rating statistics and a localized summary with an empty reviews list. A model with no reviews -- including a well-formed but unrecognized model_number -- returns an empty reviews list rather than an error, because Adidas answers 200 with a zero count rather than 404.

Required: model_number. Optional: locale, rating, topic, page.

Sampled 14 Oct 2026: 10 items. Filled in every item: id, rating, rating_range, headline, body, author, locale, recommended and 2 more. Not in every item: color (3), badges (3). In the sample: submitted_at: 2026-10-11 to 2026-10-13; rating: 1 to 5, median 5; recommended: true in 9 of 10; badges: median 1 entry.

Open in Playground

Search or browse Adidas products

Searches Adidas.com product listings by keyword, or browses a category listing by taxonomy slug, with real pagination and sort options. Exactly one of query or category is required. Returns product summaries (title, price, rating, images, color variants) plus facet filter groups, sort options, and (for category browse) a breadcrumb trail. Keyword search is best-effort relevance, not a guaranteed match: an obscure keyword returns whatever Adidas's own search index surfaces. A genuinely empty keyword search returns an empty product list, and requesting a page beyond the available result pages (or an unknown category) returns a not-found error. Category values are the path segment after /us/ in an Adidas category URL (e.g. women-athletic_sneakers); they can also be read from the url fields of a search/category response's own filters and breadcrumbs. Facets are applied by composing them into the category slug rather than by a separate parameter: each filters[].values[].slug is a token you splice into the category value (e.g. category=women-black-athletic_sneakers applies the Color=Black facet, and category=women-athletic_sneakers-prime applies Shipping=PRIME). Use filters[].key (the facet's stable name, e.g. searchcolor) rather than filters[].id, which is an opaque per-deployment UUID that cannot be used to build a request. Note the token's position within the slug varies by facet, so compose from a slug you have seen rather than assuming a fixed order.

Optional: query, category, sort, page.

Sampled 14 Oct 2026: 48 items. Filled in every item: id, model_number, title, subtitle, url, division, category, sport and 9 more. Not in every item: surface (47), color_variations (47), orderable (47), rating (46), discount_percent (16), unisex (1). In the sample: online_from: 2023-01-01 to 2026-10-05; subtitle: Women's Originals (36), Women's Sportswear (11), Basketball (1); price: 40 to 170, median 100; model_number: “IH9052RS” and 18 other values; url: adidas.com; orderable: true in 47 of 47; sport: median 1 entry; title: “HANDBALL SPEZIAL SHOES” and 20 other values.

Open in Playground

Get an Adidas store

Returns detail for one Adidas retail store: name, status, phone, description, full address, coordinates, opening hours, and in-store services (e.g. Click and Collect, Free Wi-Fi). store_id is the numeric Adidas store id, taken from an adidas-stores response's stores[].id field. An unknown store_id returns a not-found error.

Required: store_id.

Sampled 14 Oct 2026: 7 items. Filled in every item: day, status, from, to. In the sample: day: “SUNDAY” and 6 other values.

Open in Playground

Find nearby Adidas stores

Returns Adidas physical retail stores nearest to a coordinate, sourced from Adidas's own store-finder API: name, address, phone, coordinates, distance in miles, opening hours, and in-store feature flags. lat and lng are both required. Adidas's upstream ignores a caller-supplied radius and returns the nearest ~20 stores ordered by distance. A location with no stores returns an empty list rather than an error.

Required: lat, lng. Optional: page.

Sampled 14 Oct 2026: 17 items. Filled in every item: id, name, city, street, phone, latitude, longitude, distance_miles and 1 more. Not in every item: features (13). In the sample: distance_miles: 1.17 to 38.74, median 18.25; name: “adidas Flagship Store New York” and 16 other values; features: median 5 entries; city: “New York” and 9 other values; opening_hours: median 7 entries.

Open in Playground

Get Adidas search suggestions

Returns the top matching products for a partial query, the same search-as-you-type preview Adidas's own search box shows. Adidas has no separate term-autocomplete index, so each suggestion is a matching product (id, title, url, image, price) rather than a completed search phrase. Best-effort relevance: an obscure query returns whatever Adidas's own search surfaces.

Required: query.

Sampled 14 Oct 2026: 10 items. Filled in every item: id, title, url, image_url, price. In the sample: title: SAMBA OG SHOES (4), Samba OG Shoes (3), SAMBA JANE SHOES (2) and 1 more; price: 55 to 130, median 100; url: adidas.com; image_url: assets.adidas.com.

Open in Playground