# Intermarché Search

## Overview

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

## Description

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

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

## Example Response

### Search 'lait' in store 11301

```json
{
  "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
  }
}
```

## Documentation

## Overview
Search grocery products on Intermarché for a chosen store: titles, prices, packaging and product links.

1. Find a `shop_id` with the [Stores Finder](https://www.piloterr.com/library/finder-intermarche-stores) (try `Paris`)
2. Pass a keyword such as `lait`, or a search URL on intermarche.com

## Quickstart
```
GET https://api.piloterr.com/v2/intermarche/search?query=lait&shop_id=11301
GET https://api.piloterr.com/v2/intermarche/search?query=pates&shop_id=11301&page=1
GET https://api.piloterr.com/v2/intermarche/search?query=https://www.intermarche.com/recherche/lait&shop_id=11301
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword or `/recherche/{keyword}` URL |
| `shop_id` | string | yes | Store id from the Stores Finder |
| `page` | integer | no | Page number starting at 1 |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].ean` | string | Product barcode (EAN) |
| `results[].title` | string | Product title |
| `results[].brand` | string \| null | Brand |
| `results[].url` | string | Product page URL |
| `results[].price` | number \| null | Price in EUR |
| `results[].price_display` | string \| null | Price as shown on the site |
| `results[].currency` | string \| null | Currency (`EUR`) |
| `results[].unit_price` | string \| null | Unit price label |
| `results[].packaging` | string \| null | Pack size |
| `results[].image` | string \| null | Product image |
| `results[].shop_id` | string | Store used for the request |
| `results[].position` | integer | Rank on the page |
| `pagination.page` | integer | Current page |
| `pagination.per_page` | integer | Results on this page |
| `pagination.total_pages` | integer \| null | Estimated page count |
| `pagination.total_results` | integer \| null | Approximate total hits |
| `pagination.next` | string \| null | Next search page URL when available |

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing store, invalid query, or unsupported URL |
| `404` | No products found |
| `500` | Upstream request failed |

## Main use cases
- Check local milk or pasta prices
- Compare two shop ids for the same keyword
- Take an EAN into Product

## Related endpoints
[Intermarché Product](https://www.piloterr.com/library/intermarche-product)
[Intermarché Stores Finder](https://www.piloterr.com/library/finder-intermarche-stores)