decathlon.fr APIdecathlon.fr ↗
Search Decathlon France products, retrieve prices, descriptions, images, variants, and customer reviews via 4 structured JSON endpoints.
curl -X GET 'https://api.parse.bot/scraper/961694c7-1bda-4ace-bfc8-4675353abcab/search_products?query=tente+camping' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Decathlon.fr by keyword. Returns up to 40 products per page with pagination. Automatically handles queries that redirect to category pages.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based) |
| limit | integer | Max number of products to return (up to 40 per page) |
| queryrequired | string | Search keyword (e.g., 'chaussures running', 'tente camping', 'velo') |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"query": "string - the search query used",
"products": "array of product objects with id, name, brand, price, price_without_tax, original_price, price_currency, price_type, image_url, url, model_id, sku_id, product_nature, available_online, reviews_count, reviews_rating, available_sizes",
"total_pages": "integer - total number of pages",
"has_next_page": "boolean - whether more pages are available",
"items_per_page": "integer - items per page (always 40)",
"total_products": "integer - total number of matching products"
},
"sample": {
"data": {
"page": 1,
"query": "tente camping",
"products": [
{
"id": "303295",
"url": "https://www.decathlon.fr/p/tente-de-camping-2-places-mh100/_/R-p-303295",
"name": "Tente de camping 2 places, MH100",
"brand": "QUECHUA",
"price": 29.99,
"sku_id": "4ea60a8f-fc26-430a-85dc-d522a07a104a",
"model_id": "8513471",
"image_url": "https://contents.mediadecathlon.com/p2579082/k$684efb64d5468fb773577cdf1cb57a08/picture.jpg",
"price_type": "STANDARD",
"reviews_count": 3636,
"original_price": null,
"price_currency": "EUR",
"product_nature": "tente",
"reviews_rating": 4.67,
"available_sizes": [
"Sans taille"
],
"available_online": true,
"price_without_tax": 24.992
}
],
"total_pages": 25,
"has_next_page": true,
"items_per_page": 40,
"total_products": 2116
},
"status": "success"
}
}About the decathlon.fr API
The Decathlon.fr API provides 4 endpoints to query sporting goods listed on decathlon.fr, covering product search, detailed product data, customer reviews, and autocomplete suggestions. The search_products endpoint returns up to 40 products per page with pricing, brand, images, and pagination metadata. get_product_details exposes color variants, sport categories, eco-design tags, and SKU-level data. Together they give structured access to Decathlon France's catalogue without manual browsing.
Search and Browse the Catalogue
The search_products endpoint accepts a required query string — for example 'chaussures running' or 'tente camping' — plus optional page and limit parameters. Each result object includes id, name, brand, price, original_price, price_without_tax, price_currency, price_type, image_url, and a product url. The response also surfaces total_products, total_pages, and has_next_page, so iterating through a full result set is straightforward. Queries that would normally redirect to a category page on the site are handled transparently.
Product Detail and Variant Data
get_product_details takes a sku_id UUID from any search_products result and returns a richer object: full name, price, available colors, associated sports categories, size label, and tags such as BUY_BACK or ECO_DESIGN. The response also includes the product url and brand, making it straightforward to build a detail view or compare specific variants. The sku_id and model_id fields bridge between endpoints — model_id is needed for the reviews endpoint.
Customer Reviews and Ratings
get_product_reviews accepts a model_id, a page number, and a page_size of up to 50. The stats object includes average_rating, total_reviews, recommended_count, percent_satisfied, a full rating_distribution breakdown, and average_attribute_ratings. Individual review objects carry rating, rating_label, title, comment, author, date, recommended, is_verified_buyer, country, and lang.
Autocomplete Suggestions
search_suggestions takes a single query string and returns three arrays: queries (suggested query strings with labels and URLs), products (top matching products with price and image), and categories (matching category entries with labels, URLs, and images). This endpoint is useful for building typeahead interfaces or discovering canonical category structures within the Decathlon France catalogue.
- Monitor price changes on specific Decathlon France products using
search_productsand tracking thepriceandoriginal_pricefields over time. - Aggregate customer sentiment by pulling
average_rating,percent_satisfied, andrating_distributionfromget_product_reviewsacross product lines. - Build a product comparison tool using
colors,sports,tags, andpricefields fromget_product_details. - Populate a typeahead search bar using the
queriesandcategoriesarrays returned bysearch_suggestions. - Identify eco-labeled or buy-back eligible gear by filtering
get_product_detailsresults forECO_DESIGNorBUY_BACKin thetagsarray. - Compile a structured catalogue of Decathlon France sporting goods across categories using paginated
search_productscalls with sport-specific queries. - Analyze verified-buyer review text by filtering
is_verified_buyerreviews fromget_product_reviewsfor sentiment or keyword analysis.
| 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 Decathlon have an official public developer API?+
What does `get_product_reviews` return beyond a star rating?+
rating and comment, the stats object includes recommended_count, percent_satisfied, a rating_distribution breakdown across star levels, and average_attribute_ratings. Each individual review also carries is_verified_buyer, country, and lang fields.Does the API cover Decathlon stores in other countries or other regional domains?+
Is stock availability or inventory data returned by any endpoint?+
How does pagination work in `search_products`?+
total_pages, has_next_page, and items_per_page (fixed at 40) alongside the current page number. Pass the page parameter incrementally to walk through the full result set for a given query.