# 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

Retrieve detailed product information from E.Leclerc by EAN barcode, including price, stock status, offers, and product attributes.

## 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

### Lookup by EAN (Sapin de Noël)

```json
{
  "ean": "3603312946485",
  "brand": null,
  "image": "https://media.e.leclerc/LEN/fp/3603312946485_1?vh=dc542d",
  "offer": {
    "price": {
      "price": 89.9,
      "is_nx_c_b": false,
      "private_copy": 0,
      "eco_contribution": 0,
      "availability_status": "En stock",
      "eco_contribution_mobilier": 0,
      "offer_availability_status": "in-stock"
    },
    "stimuli": {},
    "elected_offer": {
      "slug": "fp/sapin-givre-et-pomme-de-pin-180-cm-3603312946485?offerId=o-3603312946485",
      "stock": 5,
      "shop_id": 1,
      "shop_name": "E.Leclerc",
      "offer_type": "leclerc_national",
      "is_cross_dock": false,
      "national_offer_id": "o-3603312946485",
      "is_leclerc_national_and_local": false,
      "is_active_promotion_without_stock": false
    },
    "stimuli_picto": {},
    "category_picto": "NONE",
    "cnc_offers_count": 143,
    "other_offers_count": 0
  },
  "title": "Sapin Givré et Pomme de pin 180 cm",
  "data_layer": {
    "id": "3603312946485",
    "ean": "3603312946485",
    "name": "Sapin Givré et Pomme de pin 180 cm",
    "price": "89.90",
    "vendor": "Leclerc",
    "section": "Maison",
    "category": "maison/decoration/decoration-de-noel/sapin-de-noel",
    "in_stock": true,
    "condition": "Neuf",
    "currency_code": "EUR"
  },
  "rating_count": 3,
  "rating_average": 4.6667
}
```

## Documentation

## Overview
The E.Leclerc Product API returns detailed product data from the E.Leclerc marketplace using an EAN barcode, including pricing, stock, offers, and ratings.

## Quickstart
```
GET https://api.piloterr.com/v2/eleclerc/product?query=3603312946485
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | EAN barcode of the product |
| `store_id` | string | no | ID of a specific E.Leclerc store |

## Response fields
| Field | Type | Description |
|---|---|---|
| `ean` | string | EAN barcode |
| `title` | string | Product title |
| `offer.price.price` | number | Current price in EUR |
| `offer.price.availability_status` | string | Human-readable availability |
| `offer.elected_offer.stock` | number | Current stock quantity |
| `rating_average` | number | Average customer rating |
| `rating_count` | number | Total number of ratings |

## Notes
- If `store_id` is omitted, data is from the national online store.
- `cnc_offers_count` shows Click & Collect availability across physical stores.

## 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 up-to-date pricing and category data
- Power price comparison engines for France's leading hypermarket chain