# E.Leclerc Product ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/eleclerc/product` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/eleclerc-product | ## Description Read one E.Leclerc product by EAN or product URL. Pass store_id to get that store's price and stock. Another store returns a different price and stock. ## 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/eleclerc/product' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### LEGO Duplo at Marennes, store 1017, in stock ```json { "ean": "5702016367676", "brand": "Lego®", "image": "https://media.e.leclerc/5702016367676_1", "offer": { "price": { "price": 39.9, "availability_status": "En stock", "offer_availability_status": "in-stock" }, "elected_offer": { "slug": "fp/lego-duplo-rescue-la-caserne-de-pompiers-10903-5702016367676?offerId=m-5702016367676-1017", "stock": 1, "shop_id": "10171011", "shop_name": "E.Leclerc MARENNES", "offer_type": "leclerc_store", "national_offer_id": "m-5702016367676-1017" }, "cnc_offers_count": 1 }, "title": "Lego® Duplo® Rescue - La Caserne De Pompiers - 10903", "data_layer": { "id": "5702016367676", "ean": "5702016367676", "name": "Lego® Duplo® Rescue - La Caserne De Pompiers - 10903", "price": "39.90", "vendor": "E.Leclerc MARENNES", "in_stock": true }, "rating_count": 3, "rating_average": 5 } ``` ### LEGO Duplo at Coutras, store 1833, no local offer ```json { "ean": "5702016367676", "brand": "Lego®", "image": "https://media.e.leclerc/5702016367676_1", "offer": { "price": { "price": null, "availability_status": "Indisponible", "offer_availability_status": "unavailable" }, "elected_offer": { "slug": "fp/lego-duplo-rescue-la-caserne-de-pompiers-10903-5702016367676?offerId=m-5702016367676-1833", "stock": 0, "shop_id": "1833", "shop_name": null, "offer_type": null, "national_offer_id": "m-5702016367676-1833" }, "cnc_offers_count": 1 }, "title": "Lego® Duplo® Rescue - La Caserne De Pompiers - 10903", "data_layer": { "id": "5702016367676", "ean": "5702016367676", "name": "Lego® Duplo® Rescue - La Caserne De Pompiers - 10903", "price": null, "vendor": "Leclerc", "in_stock": false }, "rating_count": 3, "rating_average": 5 } ``` ## Documentation ## Overview The E.Leclerc Product API returns detailed product data from E.Leclerc using an EAN or a product page URL. The response includes pricing, stock, offer details, brand, images, ratings, and the ADEME environmental cost when the product has one. ## Quickstart ``` GET https://api.piloterr.com/v2/eleclerc/product?query=3564700201442 GET https://api.piloterr.com/v2/eleclerc/product?query=5702016367676&store_id=1017 GET https://api.piloterr.com/v2/eleclerc/product?query=5702016367676&store_id=1833 GET https://api.piloterr.com/v2/eleclerc/product?query=https://www.e.leclerc/fp/jus-de-citron-de-sicile-2-x-125-ml-rustica-3564700201442 ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | EAN barcode or `www.e.leclerc/fp/...` product URL | | `store_id` | string | no | ID of a specific E.Leclerc store (from the Stores API) | ## Response fields | Field | Type | Description | |---|---|---| | `ean` | string | EAN barcode | | `title` | string | Product title | | `brand` | string \| null | Product brand | | `image` | string | Product image URL | | `offer.price.price` | number | Current price in EUR | | `offer.price.availability_status` | string | Human-readable availability (e.g. "En stock") | | `offer.price.offer_availability_status` | string | Machine-readable status (e.g. "in-stock") | | `offer.elected_offer.stock` | number | Current stock quantity | | `offer.elected_offer.offer_type` | string | Offer type (`leclerc_national`, `leclerc_store`, `marketplace`) | | `offer.elected_offer.shop_name` | string | Shop or marketplace seller name | | `offer.cnc_offers_count` | number | Number of Click & Collect offers across stores | | `environmental_cost` | object \| null | ADEME environmental cost when published | | `environmental_cost.impact_points` | number | Total impact points | | `environmental_cost.points_per_kg` | number | Impact points per kilogram | | `environmental_cost.label` | string | Raw label from E.Leclerc | | `rating_average` | number \| null | Average customer rating | | `rating_count` | number \| null | Total number of ratings | | `data_layer.in_stock` | boolean | Whether the product is in stock | ## Store price and stock Pass `store_id` to read that store's price and stock. The same EAN in another store is a different response. On 30 Oct 2026, the LEGO Duplo fire station `5702016367676` is in stock at Marennes (`1017`, 39.90 EUR, stock 1) and has no local offer at Coutras (`1833`, no price, stock 0). A store that does not sell the product still returns the product, with `offer.elected_offer.shop_id` set to the requested store. ## Notes - If `store_id` is not provided, the product is fetched from the national E.Leclerc online store. - `environmental_cost` is `null` when E.Leclerc does not publish a score for that product. - Marketplace products resolve from catalog IDs when the national `o-{ean}` offer is missing. - `cnc_offers_count` indicates how many physical stores have Click & Collect availability. ## Main use cases - Build real-time price monitoring tools for French retail and grocery products - Track E.Leclerc stock availability for specific EANs across regions - Enrich product databases with pricing, brand, and environmental cost data - Power price comparison engines covering France's leading hypermarket chain