# Decathlon Product ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/decathlon/product` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/decathlon-product | ## Description 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. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/decathlon/product' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Quechua bottle in France ```json { "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", "brand": "QUECHUA", "color": "bleu canard", "price": 9.99, "images": [ "https://contents.mediadecathlon.com/p2579584/k$6ca4ddf66bdc61cefd58225cb14ae926/picture.jpg", "https://contents.mediadecathlon.com/p2851411/k$c612714aa771cbc61caf653fce5a5761/picture.jpg" ], "rating": 4.58, "region": "fr", "currency": "EUR", "in_stock": true, "variants": [ { "sku": "c98m8612536", "url": "https://www.decathlon.fr/p/gourde-alu-1l-avec-bouchon-instantane-composee-a-100percent-d-alu-recycle-bleu/330041/c98m8612536", "name": "Gourde alu 1L avec bouchon instantané, composée à 100% d’alu recyclé, bleu", "color": "bleu canard", "price": 9.99, "currency": "EUR", "in_stock": true, "image_url": "https://contents.mediadecathlon.com/p2579584/k$6ca4ddf66bdc61cefd58225cb14ae926/picture.jpg", "product_id": "330041", "price_display": "9,99 €" }, { "sku": "c261m8914342", "url": "https://www.decathlon.fr/p/gourde-alu-1l-avec-bouchon-instantane-composee-a-100percent-d-alu-recycle-vert/330041/c261m8914342", "name": "Gourde alu 1L avec bouchon instantané, composée à 100% d’alu recyclé, vert", "color": "vert eucalyptus", "price": 9.99, "currency": "EUR", "in_stock": true, "image_url": "https://contents.mediadecathlon.com/p2851411/k$c612714aa771cbc61caf653fce5a5761/picture.jpg", "product_id": "330041", "price_display": "9,99 €" } ], "image_url": "https://contents.mediadecathlon.com/p2579584/k$6ca4ddf66bdc61cefd58225cb14ae926/picture.jpg", "product_id": "330041", "breadcrumbs": [ { "url": "https://www.decathlon.fr/", "name": "Home" }, { "url": "https://www.decathlon.fr/tous-les-sports", "name": "Tous les sports" }, { "url": "https://www.decathlon.fr/tous-les-sports/randonnee-trek", "name": "Randonnée - Trek" } ], "description": "Résistante, en aluminium, cette gourde avec son bouchon verrouillable à ouverture rapide vous accompagnera dans vos randonnées et vos déplacements quotidiens (1L).", "review_count": 4700, "price_display": "9,99 €" } ``` ### Van Rysel RCR 105 DI2 in the US ```json { "sku": "5320706", "url": "https://www.decathlon.com/products/van-rysel-rcr-105-di2-357620?variant=42064466313278", "name": "Van Rysel RCR 105 DI2", "brand": "Van Rysel", "price": 4999, "handle": "van-rysel-rcr-105-di2-357620", "images": [ "https://cdn.shopify.com/s/files/1/1330/6287/files/RCR_105_DI2_BLACK_-_8883076_-_001_---_Expires_on_12-11-2033_011e783c-f957-4ba1-b298-b51525620f56.jpg?v=1760088595", "https://cdn.shopify.com/s/files/1/1330/6287/files/RCR105DI2BLACK-8883076-001---Expireson12-11-2033.jpg?v=1760088543" ], "region": "us", "currency": "USD", "in_stock": true, "variants": [ { "sku": "5320706", "name": "Smoked Black / XL", "price": 4999, "option1": "Smoked Black", "option2": "XL", "currency": "USD", "available": true, "variant_id": "42064466313278", "price_display": "$4,999.00" } ], "image_url": "https://cdn.shopify.com/s/files/1/1330/6287/files/RCR_105_DI2_BLACK_-_8883076_-_001_---_Expires_on_12-11-2033_011e783c-f957-4ba1-b298-b51525620f56.jpg?v=1760088595", "product_id": "7884172296254", "variant_id": "42064466313278", "description": "This bike is for racers obsessed with achieving the perfect balance of aerodynamics, weight and rigidity. RCR stands for \"racer\", because that's who it's for.", "product_type": "Road bike", "price_display": "$4,999.00" } ``` ## Documentation ## 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. ## 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®ion=fr GET https://api.piloterr.com/v2/decathlon/product?query=tent®ion=uk GET https://api.piloterr.com/v2/decathlon/product?query=https://www.decathlon.com/products/van-rysel-rcr-105-di2-357620®ion=us ``` ## 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`. | ## 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 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 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 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 | ## Related [Decathlon Search](https://www.piloterr.com/library/decathlon-search) lists products.