# Intermarché Product

## Overview

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

## Description

Read one Intermarché product for a chosen store. Pass an EAN or a product URL plus the shop id.

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

## Example Response

### Flan pâtissier in store 11301

```json
{
  "ean": "3250391522828",
  "url": "https://www.intermarche.com/produit/flan-patissier-cuit-&-dore-au-four/3250391522828",
  "unit": "€/Kg",
  "brand": "Pâturages, une marque Intermarché",
  "image": "https://assets-big.cdn-mousquetaires.com/medias/domain11815/media131044/9313237-larns7kgb4-ecommint.jpg",
  "price": 3.06,
  "stock": 8,
  "title": "Flan pâtissier, cuit & doré au four",
  "images": [
    "https://assets-big.cdn-mousquetaires.com/medias/domain11815/media131044/9313237-larns7kgb4-ecommint.jpg"
  ],
  "origin": "France",
  "shop_id": "11301",
  "capacity": 400,
  "currency": "EUR",
  "in_stock": true,
  "packaging": "les 4 pots de 100 g - 400g",
  "was_price": null,
  "nutriscore": "C",
  "unit_price": 7.65,
  "description": "Flan Pâtissier",
  "price_display": "3,06 €"
}
```

## Documentation

## Overview
Get a full Intermarché product sheet for a chosen store: title, price, stock, Nutri-Score, origin and images.

1. Find a `shop_id` with the [Stores Finder](https://www.piloterr.com/library/finder-intermarche-stores)
2. Pass a product URL or an EAN

## Quickstart
```
GET https://api.piloterr.com/v2/intermarche/product?query=3250391522828&shop_id=11301
GET https://api.piloterr.com/v2/intermarche/product?query=https://www.intermarche.com/produit/flan-patissier-cuit-&-dore-au-four/3250391522828&shop_id=11301
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product URL or EAN |
| `shop_id` | string | yes | Store id from the Stores Finder |

## Response fields
| Field | Type | Description |
|---|---|---|
| `ean` | string | Product barcode (EAN) |
| `title` | string | Product title |
| `brand` | string \| null | Brand |
| `price` | number \| null | Price in EUR |
| `price_display` | string \| null | Price as shown on the site |
| `currency` | string \| null | Currency (`EUR`) |
| `unit_price` | number \| null | Price per kg when available |
| `packaging` | string \| null | Pack size |
| `stock` | integer \| null | Available stock |
| `in_stock` | boolean \| null | Whether the product is in stock |
| `nutriscore` | string \| null | Nutri-Score letter |
| `origin` | string \| null | Origin |
| `images` | string[] | Image gallery |
| `shop_id` | string | Store used for the request |

## Main use cases
- Open the product a search card returned
- See stock and Nutri-Score in that shop
- Keep the price tied to the shop id

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing store or invalid query |
| `404` | Product not found in that store |
| `500` | Upstream request failed |

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