# Auchan Product

## Overview

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

## Description

Effortlessly extract product details from Auchan for dynamic business insights, including nutritional information, ingredients, ratings, and reviews.

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

## Example Response

### Lookup Auchan product - Spécialité pommes mangues

```json
{
  "id": "C1177497",
  "url": "https://www.auchan.fr/charles-alice-specialite-pommes-mangues-sans-sucres-ajoutes/pr-C1177497",
  "brand": "CHARLES & ALICE",
  "image": "https://cdn.auchan.fr/media/A0220060320000546212PRIMARY_2048x2048/B2CD/?format=rw&quality=75&width=1200&height=1200",
  "title": "Spécialité pommes mangues sans sucres ajoutés",
  "rating": 4,
  "features": {
    "ean": "3297760097143",
    "contact": {
      "exploitant": "CHARLES & ALICE ROUTE DE LIVRON 26400 ALLEX",
      "service_consommateur": "CHARLES & ALICE ROUTE DE LIVRON 26400 ALLEX"
    },
    "reference": "546212",
    "description": "Des recettes sans sucres ajoutés, sans édulcorants et sans conservateur, qui laissent s'exprimer la gourmandise naturelle des fruits.",
    "ingredients": "Purée et morceaux de mangues 50%, purée de pommes 49.8%, arôme naturel, antioxydant : acide ascorbique.",
    "pays_de_fabrication": "France",
    "valeurs_nutritionnelles": {
      "sel": "< 0,01 g",
      "glucides": "14 g",
      "proteines": "0,5 g",
      "dont_sucres": "13 g",
      "matieres_grasses": "0,5 g",
      "fibres_alimentaires": "1,5 g",
      "valeur_energetique_kj": "277 kJ",
      "valeur_energetique_kcal": "66 kcal",
      "dont_acides_gras_satures": "0,2 g"
    },
    "denomination_legale_de_vente": "Spécialité de Mangues Pommes SSA 4x100g"
  },
  "attributes": [
    "4x95g"
  ],
  "reviews_count": 13,
  "reviews_details": {
    "average_rating": 4.1,
    "rating_distribution": {
      "1": 2,
      "2": 0,
      "3": 1,
      "4": 2,
      "5": 8
    }
  }
}
```

## Documentation

## Overview
Extract comprehensive product details from any Auchan.fr product page. Returns structured data including product title, brand, images, ratings, reviews, ingredients, nutritional values, EAN code, and country of origin: ideal for food industry analytics, product catalog management, and competitive intelligence.

## Quickstart
```
GET https://api.piloterr.com/v2/auchan/product?query=https://www.auchan.fr/charles-alice-specialite-pommes-mangues-sans-sucres-ajoutes/pr-C1177497
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full URL of the Auchan product page |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | Unique product identifier |
| `url` | string | Canonical product URL on auchan.fr |
| `brand` | string | Product brand name |
| `image` | string | Main product image URL |
| `title` | string | Product title |
| `rating` | number | Average customer rating |
| `attributes` | string[] | Product attributes (e.g. weight, quantity) |
| `reviews_count` | number | Total number of reviews |
| `features.ean` | string | EAN barcode |
| `features.ingredients` | string | Full ingredients list |
| `features.pays_de_fabrication` | string | Country of manufacture |
| `features.valeurs_nutritionnelles` | object | Nutritional values |

## Notes
- Only `auchan.fr` product URLs are supported.
- Non-food products will have fewer `features` fields.

## Main use cases
- Extract nutritional and ingredient data from Auchan for food compliance monitoring and labeling automation
- Enrich product databases with EAN codes, brand information, and images from the French retail market
- Monitor product ratings and review trends on Auchan to identify top-performing or declining SKUs
- Power competitive analysis tools comparing product prices and attributes across French supermarkets