Decathlon Search API

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.

Active1 credit = 1 requestGET/v2/decathlon/search

Get API key

Try endpoint for free

Endpoint Overview

Detailed documentation, pricing, and usage examples.

Try now for free

OverviewLink to Overview

Search Decathlon country shops. France and the other Decathlon country pages are read with the website crawler. The US shop is Shopify: its search page is HTML from the same crawler.

query is a keyword or a search or category link. region chooses the shop. The default is fr. A full link picks the shop. If region names another shop, the call 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/search?query=gourde
GET https://api.piloterr.com/v2/decathlon/search?query=gourde&region=fr&page=2
GET https://api.piloterr.com/v2/decathlon/search?query=https://www.decathlon.fr/search?Ntt=gourde
GET https://api.piloterr.com/v2/decathlon/search?query=tent&region=uk
GET https://api.piloterr.com/v2/decathlon/search?query=bike&region=us

ParametersLink to Parameters

Parameter	Type	Required	Description
`query`	string	yes	Keyword or Decathlon search link. Placeholder: `gourde`. A product link returns 400.
`region`	string	no	Country shop. Default `fr`. Placeholder: `fr`.
`page`	integer	no	Page number from 1. European shops use `from` and `size` (40). The US shop uses `page` (24).
`return_page_source`	boolean	no	When true, the response is the raw HTML 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

Response fieldsLink to Response fields

Each item in results is one card. price is a number. price_display is that amount in the shop currency, with cents. France uses euros (9,99 €). The US shop uses dollars ($8,499.00). pagination.next is the next page URL, or null.

France, gourde, first card: price 9.99 and price_display 9,99 €. United States, bike, first card: price 8499 and price_display $8,499.00.

Main use casesLink to Main use cases

Monitor sports-gear prices in France, the UK, and the US shop
Build an assortment from a category or search URL
Compare the same keyword across euro, pound, and dollar shops

Error codesLink to Error codes

Code	Meaning
400	Empty query, unknown shop, another website, a product link, or region conflicting with the URL
404	No product cards in the HTML
500	The fetch failed

Decathlon Product reads one product URL.

Related APIs

Expand your data capabilities with these complementary tools.

View All

Decathlon Product/v2/decathlon/product

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.

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)

Talk to a data expert