Piloterr

Intermarché Search

GET
/v2/intermarche/search

Search Intermarché groceries for one store. Pass a keyword and the shop id from the store finder, then page the aisle.

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

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

Query Parameters

query*string

Search keyword or full Intermarché search URL.

Examples:

lait
pates
https://www.intermarche.com/recherche/lait

Use the Product endpoint when you already have a product URL or EAN.

shop_id*string

Intermarché store id. Resolve a city with the Stores Finder (for example query=Paris).

Example:

11301
page?number

Page number starting at 1. Use pagination.total_pages from a previous response to iterate.

Example: 2

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/intermarche/search?query=string&shop_id=string'
Example Response
{  "results": [    {      "ean": "3533630097654",      "url": "https://www.intermarche.com/produit/grandlait-frais-lait-frais-de-montagne-entier/3533630097654",      "brand": "Grandlait",      "image": "https://assets-big.cdn-mousquetaires.com/medias/domain11815/media140040/12012075-ubbxcayb3o-ecommint.jpg",      "price": 1.61,      "title": "Grandlait frais - Lait frais de Montagne entier",      "shop_id": "11301",      "currency": "EUR",      "position": 1,      "packaging": "la bouteille de 1 l",      "unit_price": "1,61 €/L",      "price_display": "1,61 €"    },    {      "ean": "3451790000840",      "url": "https://www.intermarche.com/produit/candia-grandlait-lait-entier/3451790000840",      "brand": "Candia",      "image": null,      "price": 1.29,      "title": "Candia GrandLait - Lait entier",      "shop_id": "11301",      "currency": "EUR",      "position": 2,      "packaging": "la bouteille de 1 l",      "unit_price": "1,29 €/L",      "price_display": "1,29 €"    }  ],  "pagination": {    "next": "https://www.intermarche.com/recherche/lait?page=2",    "page": 1,    "per_page": 40,    "total_pages": 15,    "total_results": 588  }}