# Auchan Search

## Overview

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

## Description

Extract Auchan product listings from keyword searches for insightful market analysis and competitive edge.

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

## Example Response

### Search by keyword 'pomme'

```json
{
  "results": [
    {
      "id": "ebe83997-d91f-4a7e-8721-fed0fc3acf1e",
      "url": "https://www.auchan.fr/pommes-bicolores/pr-C1350678",
      "brand": null,
      "image": null,
      "title": "Pommes Bicolores",
      "rating": 3,
      "attributes": [
        "2kg"
      ],
      "reviews_count": 9
    },
    {
      "id": "e7e43bcc-6fdc-4e65-8a08-ed7fcf8fe95f",
      "url": "https://www.auchan.fr/pommes-pink-lady/pr-C1350629",
      "brand": null,
      "image": null,
      "title": "Pommes Pink Lady",
      "rating": 4.5,
      "attributes": [
        "6 pièces"
      ],
      "reviews_count": 8
    },
    {
      "id": "bf162b02-38fd-4380-960c-ca44879855f6",
      "url": "https://www.auchan.fr/auchan-bio-pommes-golden/pr-C1350162",
      "brand": "AUCHAN BIO",
      "image": "https://cdn.auchan.fr/media/PICTOSTEP201048057_0x0/B2CD/",
      "title": "Pommes Golden",
      "rating": 3,
      "attributes": [
        "1kg"
      ],
      "reviews_count": 6
    },
    {
      "id": "b410b2be-00b6-422a-b70c-356a547280d4",
      "url": "https://www.auchan.fr/cultivons-le-bon-pommes-golden/pr-C1350030",
      "brand": null,
      "image": "https://cdn.auchan.fr/media/PICTOSTEP122680319_0x0/B2CD/",
      "title": "CULTIVONS LE BON Pommes Golden",
      "rating": 2.5,
      "attributes": [
        "6 pièces"
      ],
      "reviews_count": 6
    },
    {
      "id": "bdb082a9-79ad-4371-8142-db762f42d676",
      "url": "https://www.auchan.fr/pommes-jazz/pr-C1350141",
      "brand": null,
      "image": null,
      "title": "Pommes Jazz",
      "rating": 4,
      "attributes": [
        "6 pièces"
      ],
      "reviews_count": 10
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "other_pages": [
      2,
      3,
      4,
      5,
      6,
      25
    ],
    "has_next_page": true
  }
}
```

## Documentation

## Overview
Search for products on Auchan.fr using a keyword or a full Auchan search URL. Returns paginated product listings with titles, brands, ratings, review counts, images, and attributes: enabling product discovery, catalog enrichment, and competitive monitoring across France's leading supermarket chain.

## Quickstart
```
GET https://api.piloterr.com/v2/auchan/search?query=pomme
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword or full Auchan search URL |
| `page` | number | no | Page number for paginated results (default: `1`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].id` | string | Unique product identifier |
| `results[].url` | string | Product URL on auchan.fr |
| `results[].brand` | string\|null | Product brand |
| `results[].image` | string\|null | Product image URL |
| `results[].title` | string | Product title |
| `results[].rating` | number\|null | Average rating |
| `results[].attributes` | string[] | Product attributes |
| `results[].reviews_count` | number\|null | Number of reviews |
| `pagination` | object | Pagination info (current, next, has_next_page) |

## Notes
- Use `pagination.has_next_page` to implement full result pagination.
- Both plain keywords and full Auchan search URLs are accepted.

## Main use cases
- Scrape Auchan search results to monitor product availability and pricing trends across French retail
- Build product discovery pipelines to identify which brands and SKUs appear for target keywords
- Automate catalog synchronization by periodically searching and updating product data from Auchan
- Conduct competitive benchmarking by comparing product listings across French supermarket chains