# Eleclerc Stores Finder

## Overview

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

## Description

Search Eleclerc stores by name or city to retrieve contact details, opening hours, and geolocation.

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

## Example Response

### Search by city 'paris'

```json
[
  {
    "id": "1893t128t1",
    "name": "PARIS PICPUS",
    "address": {
      "city": "PARIS",
      "lines": [
        "67 rue de Picpus"
      ],
      "zipcode": "75012",
      "country_code": null
    },
    "contact": {
      "email": null,
      "phone": "01 87 46 07 00"
    },
    "geometry": {
      "type": "Point",
      "coordinates": [
        2.3950581,
        48.8454278
      ]
    },
    "store_id": "1893",
    "opening_hours": {
      "usual": {
        "1": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "2": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "3": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "4": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "5": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "6": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "7": [
          {
            "end": "13:00",
            "start": "08:30"
          }
        ]
      },
      "timezone": "Europe/Paris"
    },
    "weekly_opening": {
      "1": {
        "hours": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "isSpecial": false
      },
      "2": {
        "hours": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "isSpecial": false
      },
      "3": {
        "hours": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "isSpecial": false
      },
      "4": {
        "hours": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "isSpecial": false
      },
      "5": {
        "hours": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "isSpecial": false
      },
      "6": {
        "hours": [
          {
            "end": "21:30",
            "start": "07:30"
          }
        ],
        "isSpecial": false
      },
      "7": {
        "hours": [
          {
            "end": "13:00",
            "start": "08:30"
          }
        ],
        "isSpecial": false
      },
      "timezone": "Europe/Paris"
    }
  }
]
```

## Documentation

## Overview
The Eleclerc Stores Finder endpoint allows you to search for Piloterr-supported E.Leclerc stores. It returns an array of stores ordered by reach: stores serving the most people appear first. This endpoint is free to use and is ideal for locating E.Leclerc stores before calling the Eleclerc Search or Product APIs with a `store_id`.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Case-insensitive string to filter store names |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | Unique store identifier |
| `store_id` | string | E.Leclerc store ID, usable in the Eleclerc Search API |
| `name` | string | Store name |
| `contact` | object | Store contact info (email, phone) |
| `address` | object | Store address (lines, city, zipcode, country_code) |
| `weekly_opening` | object | Weekly opening hours per day (1=Monday to 7=Sunday) |
| `opening_hours` | object | Structured opening hours with timezone |
| `geometry` | object | GeoJSON Point with GPS coordinates |

## Notes
- Results are ordered by reach (stores with the highest footfall first)
- The `store_id` field can be passed directly to the Eleclerc Search API
- The search is case-insensitive

## Main use cases
- Locate the nearest E.Leclerc store by city name before fetching local prices
- Resolve store names to IDs for use in the Eleclerc Search or Product API
- Build store locator features for French retail applications
- Enrich datasets with E.Leclerc store contact information and opening hours