Skip to main content
Network status
Log in
Piloterr
Back to library

Decathlon Product API

Read one Decathlon product from a product URL, a product path, or a keyword. A keyword uses the first search hit. Set region when the query does not already name the shop.

Active1 credit = 1 requestGET/v2/decathlon/product
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Read one Decathlon product. European and other Decathlon country pages use the Decathlon product sheet. The US shop is Shopify: the product is the Shopify product JSON (/products/{handle}.js), not the French HTML template.

query is a product link, a product path, or a keyword. A keyword opens the first search hit. A search link returns 400. The default region is fr. A full link picks the shop. A conflicting region returns 400.

The US shop (us, www.decathlon.com) is Shopify. Search is the Shopify results page. A product is read from the Shopify product JSON, not from the French Decathlon template. gb means uk. be is the French shop on decathlon.be. be-nl is the Dutch shop. ch is the French shop on decathlon.ch.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/decathlon/product?query=https://www.decathlon.fr/p/gourde-alu-1l-avec-bouchon-instantane-composee-a-100percent-dalu-recycle-bleu/330041/c98m8612536
GET https://api.piloterr.com/v2/decathlon/product?query=gourde&region=fr
GET https://api.piloterr.com/v2/decathlon/product?query=tent&region=uk
GET https://api.piloterr.com/v2/decathlon/product?query=https://www.decathlon.com/products/van-rysel-rcr-105-di2-357620&region=us

ParametersLink to Parameters

Parameter Type Required Description
query string yes Product link, /p/... or /products/... path, or a keyword. Placeholder: the Quechua bottle URL. A search link returns 400.
region string no Country shop when query is a keyword or a path. Default fr.
return_page_source boolean no When true, the response is the raw page body in result.

RegionsLink to Regions

region Shop Currency Page
fr www.decathlon.fr EUR Decathlon
es www.decathlon.es/es EUR Decathlon
it www.decathlon.it EUR Decathlon
pt www.decathlon.pt EUR Decathlon
nl www.decathlon.nl EUR Decathlon
be www.decathlon.be/fr EUR Decathlon
be-nl www.decathlon.be/nl EUR Decathlon
uk www.decathlon.co.uk GBP Decathlon
ch www.decathlon.ch/fr CHF Decathlon
us www.decathlon.com USD Shopify

The US shop (us, www.decathlon.com) is Shopify. A product is read from the Shopify product JSON, not from the French Decathlon template. gb means uk. be is the French shop on decathlon.be. be-nl is the Dutch shop. ch is the French shop on decathlon.ch.

Response fieldsLink to Response fields

The body is one flat product. price is a number and price_display is that amount in the shop currency. The Quechua bottle in France is 9.99 and 9,99 €. The Van Rysel bike in the US is 4999 and $4,999.00. There is no results wrapper.

France example: Quechua bottle, price 9.99, price_display 9,99 €, currency EUR. US example: Van Rysel RCR 105 DI2, price 4999, price_display $4,999.00, currency USD. This record comes from the Shopify product JSON.

Main use casesLink to Main use cases

  • Track one bottle, tent, or bike SKU over time
  • Fill a PIM with title, price, and images
  • Read the US Shopify product and a French product sheet the same way

Error codesLink to Error codes

Code Meaning
400 Empty query, unknown shop, another website, a search link, or region conflicting with the URL
404 The page had no product price
500 The fetch failed

RelatedLink to Related

Decathlon Search lists products.

Related APIs

Expand your data capabilities with these complementary tools.

View All
Decathlon Search/v2/decathlon/search

Search a Decathlon shop with a keyword or a search URL. Choose the country with region, or let a full link pick the shop, then page through titles, prices, and product links.

GET1 credit = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert