Piloterr

E.Leclerc Suggest

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

Credit cost: 1 credit per call

GET
/v2/eleclerc/suggest

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Search term or EAN to get product suggestions for.

Accepted input types:

  • keyword: partial product name or category (e.g. pomme)
  • EAN: full product barcode (e.g. 9782330149635)

Example:

pomme

Notes:

  • Returns up to 6 autocomplete suggestions matching the query.
  • Each suggestion includes the product URL, slug, title, subtitle (author/brand), and image URL.
  • This endpoint mirrors the E.Leclerc website autocomplete search box.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/eleclerc/suggest?query=string"

{
  "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"
    }
  ]
}

{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}