Decathlon API
Decathlon API returns live Decathlon data as clean JSON for decathlon The primary endpoint, search, returns product results including product id, handle, title, vendor and product type.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Developers reach for it when they need to validate, enrich, classify and normalize operational data without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Decathlon scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, product_detail. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/decathlon/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "hiking boots"
}
}{
"ok": true,
"meta": {
"api": "decathlon",
"endpoint": "search",
"mode": "live",
"latency_ms": 19.7,
"record_count": 20,
"bytes": 0,
"cache_hit": false,
"completeness_pct": 100,
"stop_reason": "limit_reached",
"method": "shopify_json",
"search_mode": "catalog",
"ranking": "engine_relevance",
"source": {
"route": "/products.json",
"upstream_calls": 0,
"catalog_source": "memory",
"scanned": 504
},
"pagination": {
"page": 1,
"per_page": 20,
"total_results": 35,
"returned": 20,
"has_more": true,
"next_page": 2
},
"filters": {
"applied": [
"query"
],
"ignored": []
},
"matching": {
"all_terms": 35,
"any_term": 0
},
"notes": null
},
"data": {
"products": [
{
"product_id": "[redacted-phone]",
"handle": "quechua-mens-waterproof-snow-hiking-boots-nh100-high-top-zip-black-351123-fw25",
"url": "https://www.decathlon.com/products/quechua-mens-waterproof-snow-hiking-boots-nh100-high-top-zip-black-351123-fw25",
"title": "Quechua Men’s NH100 Warm Waterproof Easy-On Snow Hiking Boots",
"vendor": "Quechua",
"product_type": "Snow boots",
"tags": [
"8851794",
"FAMILY: 11354",
"Footwear"
],
"description": "Made for men who want to embrace the simple joys of snow—walking, playing, having fun, and reconnecting with their inner child.",
"description_html": "<p>Made for men who want to embrace the simple joys of snow—walking, playing, having fun, and reconnecting with their inner child.</p>",
"image": "https://cdn.shopify.com/s/files/1/1330/6287/files/8851794-product_image-p2904869.jpg?v=[redacted-phone]",
"image_count": 8,
"available": true,
"price_min": 45,
"price_max": 45,
"compare_at_price_min": 69.99,
"compare_at_price_max": 69.99,
"currency": "USD",
"on_sale": true,
"variant_count": 9,
"in_stock_variant_count": 7,
"grams_min": 986,
"grams_max": 1318,
"skus": [
"5057675",
"5057676",
"5057677"
],
"options": [
"Color",
"Size"
],
"published_at": "[redacted-phone]T08:56:20-08:00",
"created_at": "[redacted-phone]T14:20:22-07:00",
"updated_at": "[redacted-phone]T05:53:41-07:00"
},
{
"product_id": "[redacted-phone]",
"handle": "quechua-womens-warm-and-waterproof-snow-hiking-boots-nh100-mid-black-346334-fw25",
"url": "https://www.decathlon.com/products/quechua-womens-warm-and-waterproof-snow-hiking-boots-nh100-mid-black-346334-fw25",
"title": "Quechua Women's NH100 Warm Waterproof Mid Snow Hiking Boots",
"vendor": "Quechua",
"product_type": "Snow boots",
"tags": [
"8873835",
"FAMILY: 11354",
"FW25"
],
"description": "A great balance of warmth and waterproof protection at an affordable price—perfect for occasional winter outings in town or on trails with light snow.",
"description_html": "<p>A great balance of warmth and waterproof protection at an affordable price—perfect for occasional winter outings in town or on trails with light snow.</p>",
"image": "https://cdn.shopify.com/s/files/1/1330/6287/files/8873835-product_image-p2904938.jpg?v=[redacted-phone]",
"image_count": 8,
"available": true,
"price_min": 49.99,
"price_max": 49.99,
"compare_at_price_min": null,
"compare_at_price_max": null,
"currency": "USD",
"on_sale": false,
"variant_count": 7,
"in_stock_variant_count": 4,
"grams_min": 725,
"grams_max": 978,
"skus": [
"5177939",
"5177940",
"5177941"
],
"options": [
"Color",
"Size"
],
"published_at": "[redacted-phone]T11:03:25-08:00",
"created_at": "[redacted-phone]T14:11:42-07:00",
"updated_at": "[redacted-phone]T05:53:41-07:00"
},
{
"product_id": "[redacted-phone]",
"handle": "womens-sh500-warm-waterproof-snow-hiking-boots-332914",
"url": "https://www.decathlon.com/products/womens-sh500-warm-waterproof-snow-hiking-boots-332914",
"title": "Quechua Women's SH500 Warm Waterproof Snow Hiking Boots",
"vendor": "Quechua",
"product_type": "Snow boots",
"tags": [
"8644860",
"BSG",
"DEAL"
],
"description": "As elegant as they are technical, these warm leather winter snow boots are suitable for all types of terrain thanks to their Snowcontact soles",
"description_html": "As elegant as they are technical, these warm leather winter snow boots are suitable for all types of terrain thanks to their Snowcontact soles",
"image": "https://cdn.shopify.com/s/files/1/1330/6287/files/8644860-product_image-p2289103.jpg?v=[redacted-phone]",
"image_count": 13,
"available": true,
"price_min": 95,
"price_max": 95,
"compare_at_price_min": 139,
"compare_at_price_max": 139,
"currency": "USD",
"on_sale": true,
"variant_count": 7,
"in_stock_variant_count": 3,
"grams_min": 900,
"grams_max": 1300,
"skus": [
"4294662",
"4294663",
"4294664"
],
"options": [
"Color",
"Size"
],
"published_at": "[redacted-phone]T14:55:43-08:00",
"created_at": "[redacted-phone]T14:55:43-08:00",
"updated_at": "[redacted-phone]T05:53:42-07:00"
}
],
"collection": null,
"facets": {
"product_type": [
{
"value": "Shoes",
"count": 24
},
{
"value": "Snow boots",
"count": 9
},
{
"value": "Trousers/pants",
"count": 2
}
],
"vendor": [
{
"value": "Quechua",
"count": 35
}
],
"tag": [
{
"value": "Published",
"count": 30
},
{
"value": "INVENTORY_FC_IS_NOT_0",
"count": 26
},
{
"value": "SIZE_MSG_TOO_SMALL",
"count": 26
}
],
"price": {
"min": 14,
"max": 129
}
}
}
}What the Decathlon API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search or browse the decathlon.com (US) catalogue. Give a free-text `query` ('hiking boots', 'bike helmet', 'kiprun'), a `collection` handle to browse (`running`, `womens`, `mens-hiking-boots`, `all`), or both to search inside one collection. Every result carries Decathlon's own product id and handle, the product title, house brand, product type, tags, image, price range, sale price, stock flag and — in catalogue and collection mode — the variant count, SKU list and shipping-weight range. Narrow with product_type, vendor, tag, min_price, max_price and available_only; sort by price, name or publish date; page through the whole match set. Live facet vocabularies with counts come back with every catalogue-mode response, so the filter values are never a guess. Feed a result's `handle` straight into `product_detail` for barcodes and per-variant weights. | Ops teams call search to search or browse the decathlon.com (US) catalogue. | query, collection, mode, max_results, page, ... |
| product_detail | Get one Decathlon product in full, by handle, product id or decathlon.com URL — title, house brand, product type, tags, the marketing description in both plain text and its original HTML, every image with dimensions and the variants it belongs to, product video and 3D media, the option axes with their values, and one row per size x colour variant. Each variant row carries Decathlon's own variant id, the retail SKU, the **EAN-13 barcode**, the **shipping weight in grams** (plus the merchant's own weight + unit pair), the live **inventory quantity** as a real integer, the buyable flag, price, compare-at price, tax and shipping flags, and any volume-pricing rules. Built for shipping-cost and catalogue-matching work: barcode and grams are the two fields this endpoint exists for. | Developer tools call product_detail to get one Decathlon product in full, by handle, product id or decathlon.com URL. | handle, product_id, url |
Call search from your stack
curl -X POST https://api.reefapi.com/decathlon/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"hiking boots"}'import requests
r = requests.post(
"https://api.reefapi.com/decathlon/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "hiking boots"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/decathlon/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "hiking boots"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.decathlon.search with {"query":"hiking boots"}.Who uses this API and why
- Ops teams use Decathlon to search or browse the decathlon.com (US) catalogue.
- Developer tools use Decathlon to get one Decathlon product in full, by handle, product id or decathlon.com URL.
- Validation workflows use Decathlon to validate, enrich, classify and normalize operational data, all from one ReefAPI key and credit pool.
Questions developers ask before integrating
What is the Decathlon API?
Decathlon API is a ReefAPI endpoint group for decathlon It returns live JSON through POST requests under /decathlon/v1.
Is the Decathlon API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Decathlon calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Decathlon login or account?
No login to Decathlon is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Decathlon data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Decathlon API use?
Decathlon actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Decathlon from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call decathlon actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Decathlon API a Decathlon scraper?
It is the managed alternative to a DIY Decathlon scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same decathlon back as clean JSON.
Why does my Decathlon scraper keep getting blocked?
Most Decathlon scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.