# Intermarché Stores Finder

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/finder/intermarche-stores` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 0 credits per call |
| **Documentation** | https://www.piloterr.com/library/finder-intermarche-stores |

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Look up an Intermarché store before you search products. Pass a city, a postal code, or a store name and read the shop id that Search and Product expect.

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

## Example Response

### Search by city 'Paris'

```json
[
  {
    "id": "07450",
    "url": "https://www.intermarche.com/?pdvref=07450",
    "city": "Paris",
    "name": "INTERMARCHE EXPRESS Paris",
    "format": "EXPRESS",
    "address": "14 avenue de la grande armée",
    "shop_id": "07450",
    "latitude": 48.875141,
    "store_id": "07450",
    "longitude": 2.291878,
    "trade_name": "INTERMARCHE",
    "postal_code": "75017",
    "country_code": "FR"
  }
]
```

## Documentation

## Overview
Find Intermarché stores across France. Search by city, postal code or store name and get the `shop_id` you need for the Intermarché Search and Product APIs. This endpoint is free.

## Quickstart
```
GET https://api.piloterr.com/v2/finder/intermarche-stores?query=Paris
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | City, postal code or store name (case-insensitive) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | Same value as `shop_id` |
| `shop_id` | string | Store id to pass to Search and Product |
| `store_id` | string | Alias of `shop_id` |
| `name` | string | Store name |
| `format` | string \| null | Store format (for example Intermarché Super) |
| `trade_name` | string \| null | Trade name |
| `city` | string \| null | City |
| `postal_code` | string \| null | Postal code |
| `address` | string \| null | Street address |
| `latitude` | number \| null | Latitude |
| `longitude` | number \| null | Longitude |
| `url` | string | Store page on intermarche.com |
| `country_code` | string | Country code (`FR`) |

## Notes
Use the returned `shop_id` with Intermarché Search and Product
Results cover stores in metropolitan France

## Main use cases
- Pick the shop id for a local price check
- List the stores around a postal code
- Confirm the store name before calling Search

## Related endpoints
[Intermarché Search](https://www.piloterr.com/library/intermarche-search)
[Intermarché Product](https://www.piloterr.com/library/intermarche-product)