# E.Leclerc Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/eleclerc/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/eleclerc-search |

## Description

Search for products on E.Leclerc by keyword with optional store-specific filtering and pagination.

## 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'pomme' on national store

```json
{
  "total": 1,
  "results": [
    {
      "id": "3603312946485",
      "sku": "3603312946485",
      "slug": "sapin-givre-et-pomme-de-pin-180-cm",
      "label": "Sapin Givré et Pomme de pin 180 cm",
      "family": {
        "code": "sapin_de_neol",
        "label": "Sapin de Noël",
        "logisticClassCode": "TARIF2"
      },
      "variants": [
        {
          "id": "3603312946485",
          "sku": "3603312946485",
          "slug": "sapin-givre-et-pomme-de-pin-180-cm",
          "label": "Sapin Givré et Pomme de pin 180 cm",
          "offers": [
            {
              "id": "389083277",
              "shop": {
                "id": "Leclerc",
                "label": "E.Leclerc",
                "signCode": "0100"
              },
              "stock": 53,
              "locale": "FR",
              "ranges": [
                {
                  "price": {
                    "price": 8990,
                    "priceWithAllTaxes": 8990
                  },
                  "threshold": 1
                }
              ],
              "currency": {
                "code": "EUR",
                "symbol": "€"
              },
              "isDefault": true,
              "externalId": "o-3603312946485"
            }
          ],
          "offersTotal": 1
        }
      ],
      "creationDate": "2024-10-30T09:35:22.891169Z",
      "cncOffersCount": 259,
      "lastUpdateDate": "2025-03-24T14:35:31.173215Z"
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "has_next_page": true
  }
}
```

### Search 'tournevis' page 1

```json
{
  "total": 48,
  "results": [
    {
      "id": "3601029858336",
      "sku": "3601029858336",
      "slug": "douchette-3-jets-flexible-1-75m-noir-foxter",
      "label": "Douchette 3 jets & flexible 1,75m Noir - FOXTER",
      "family": {
        "code": "pomme_de_douche_et_flexible",
        "label": "Pomme de douche et flexible",
        "logisticClassCode": "TARIF2"
      },
      "cncOffersCount": 315,
      "lastUpdateDate": "2026-03-24T10:59:11.912978Z"
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "has_next_page": true
  }
}
```

## Documentation

## Overview
The E.Leclerc Search API lets you search the E.Leclerc product catalog by keyword, returning a paginated list of products with pricing, stock, and Click & Collect data.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search keyword or phrase |
| `store_id` | string | no | ID of a specific E.Leclerc store |
| `page` | number | no | Page number for pagination (default: 1) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `total` | number | Total matching products |
| `results[].label` | string | Product name |
| `results[].variants[].offers[].ranges[].price.price` | number | Price in cents |
| `results[].variants[].offers[].stock` | number | Stock quantity |
| `results[].cncOffersCount` | number | Click & Collect store count |
| `pagination.has_next_page` | boolean | Whether more pages exist |

## Notes
- Prices are in euro cents (divide by 100 for EUR).
- Use `pagination.next` with `page` for subsequent pages.

## Main use cases
- Build price intelligence tools for E.Leclerc search results
- Monitor product availability and pricing trends across E.Leclerc's catalog
- Aggregate E.Leclerc listings for French market research and competitive analysis
- Automate catalog ingestion from France's largest hypermarket chain