Piloterr

Decathlon Search

GET
/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.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Keyword, or a Decathlon search link.

Examples:

gourde
velo
https://www.decathlon.fr/search?Ntt=gourde
https://www.decathlon.co.uk/search?Ntt=tent

A product page link belongs on Product and returns 400 here.

region?string

Country shop. Default is fr. A full link in query picks the shop, and a conflicting region returns 400.

Examples:

fr
uk
be-nl
us

gb is the same as uk. us is the Shopify shop at decathlon.com.

Default"fr"
page?number

Page number starting at 1.

Example:

2
GET https://api.piloterr.com/v2/decathlon/search?query=gourde&page=2

European shops step by 40. The US shop steps by 24.

Range1 <= value
return_page_source?boolean

Set to true to get the raw HTML in result.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/decathlon/search?query=string"

{  "results": [    {      "sku": "c98m8612536",      "url": "https://www.decathlon.fr/p/gourde-alu-1l-avec-bouchon-instantane-composee-a-100percent-dalu-recycle-bleu/330041/c98m8612536",      "name": "Gourde alu 1L avec bouchon instantané, composée à 100% d’alu recyclé, bleu",      "price": 9.99,      "rating": 4.6,      "region": "fr",      "currency": "EUR",      "image_url": "https://contents.mediadecathlon.com/p2579584/k$6ca4ddf66bdc61cefd58225cb14ae926/picture.jpg?format=auto&f=3000x0",      "product_id": "330041",      "color_count": 3,      "review_count": 4700,      "price_display": "9,99 €"    }  ],  "pagination": {    "next": "https://www.decathlon.fr/search?Ntt=gourde&from=40&size=40",    "page": 1,    "per_page": 40,    "total_pages": 25,    "total_results": 5274  }}

{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}