# E.Leclerc Suggest

## Overview

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

## Description

Get instant product autocomplete suggestions from E.Leclerc for a given keyword or EAN.

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

## Example Response

### Suggest for 'pomme'

```json
{
  "results": [
    {
      "url": "https://www.e.leclerc/fp/champagne-pommery-royal-brut-75-cl-3352379006365",
      "slug": "/fp/champagne-pommery-royal-brut-75-cl-3352379006365",
      "title": "Champagne Pommery Royal - Brut - 75 cl",
      "subtitle": "Pommery",
      "image_url": "https://media.e.leclerc/LEN/fp/3352379006365_1?vh=e2fc2b"
    },
    {
      "url": "https://www.e.leclerc/fp/cendrillon-poche-9782330149635",
      "slug": "/fp/cendrillon-poche-9782330149635",
      "title": "Cendrillon (Poche)",
      "subtitle": "Joël Pommerat",
      "image_url": "https://media.e.leclerc/LEN/fp/9782330149635_1?vh=d978e6"
    },
    {
      "url": "https://www.e.leclerc/fp/pinocchio-poche-9782330135461",
      "slug": "/fp/pinocchio-poche-9782330135461",
      "title": "Pinocchio (Poche)",
      "subtitle": "Joël Pommerat",
      "image_url": "https://fgellaobb.filerobot.com/9782330135461_1?op_sharpen=1&resmode=bilin"
    },
    {
      "url": "https://www.e.leclerc/fp/sapin-givre-et-pomme-de-pin-180-cm-3603312946485",
      "slug": "/fp/sapin-givre-et-pomme-de-pin-180-cm-3603312946485",
      "title": "Sapin Givré et Pomme de pin 180 cm",
      "subtitle": null,
      "image_url": "https://media.e.leclerc/LEN/fp/3603312946485_1?vh=dc542d"
    },
    {
      "url": "https://www.e.leclerc/fp/laxeov-cubes-transit-express-pomme-abricot-boite-de-20-palets-3770000670011",
      "slug": "/fp/laxeov-cubes-transit-express-pomme-abricot-boite-de-20-palets-3770000670011",
      "title": "Laxeov Cubes Transit Express Pomme-Abricot Boîte de 20 Palets",
      "subtitle": "Nutreov",
      "image_url": "https://media.e.leclerc/LEN/fp/3770000670011_1?vh=d3715d"
    }
  ]
}
```

### Suggest for 'sapin'

```json
{
  "results": [
    {
      "url": "https://www.e.leclerc/fp/sapin-givre-et-pomme-de-pin-180-cm-3603312946485",
      "slug": "/fp/sapin-givre-et-pomme-de-pin-180-cm-3603312946485",
      "title": "Sapin Givré et Pomme de pin 180 cm",
      "subtitle": null,
      "image_url": "https://media.e.leclerc/LEN/fp/3603312946485_1?vh=dc542d"
    },
    {
      "url": "https://www.e.leclerc/fp/sapin-de-noel-artificiel-vert-180cm-3603312938596",
      "slug": "/fp/sapin-de-noel-artificiel-vert-180cm-3603312938596",
      "title": "Sapin de Noël artificiel vert 180cm",
      "subtitle": "Sans marque",
      "image_url": "https://media.e.leclerc/LEN/fp/3603312938596_1?vh=46c0af"
    }
  ]
}
```

## Documentation

## Overview
The E.Leclerc Suggest API returns autocomplete product suggestions from the E.Leclerc search box for a keyword or EAN.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword or EAN for suggestions |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].url` | string | Full product page URL |
| `results[].title` | string | Product title |
| `results[].subtitle` | string | Brand or author |
| `results[].image_url` | string | Product image URL |

## Notes
- Returns up to 6 suggestions.
- Mirrors live E.Leclerc autocomplete behavior.

## Main use cases
- Build typeahead features for e-commerce tools targeting French customers
- Resolve product identities from partial names or EANs on E.Leclerc
- Quickly discover product URLs for downstream scraping
- Power internal search tools for French grocery or retail data