# Carrefour Product

## Overview

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

## Description

Extract full product details from a Carrefour product page, including price, brand, nutritional info, packaging, and availability.

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

## Example Response

### Lookup Café Moulu Carte Noire

```json
{
  "brand": "CARTE NOIRE",
  "image": "https://media.carrefour.fr/medias/p_1500x1500/cafemoulu.png",
  "price": "4,99€",
  "title": "Café Moulu Classique 100% Arabica Intensité 7 CARTE NOIRE",
  "currency": "€",
  "packaging": "les 2 paquets de 250g",
  "categories": [
    {
      "id": "2183",
      "slug": "epicerie-sucree",
      "label": "Epicerie sucrée",
      "level": 1
    },
    {
      "id": "39473",
      "slug": "cafes",
      "label": "Cafés",
      "level": 2
    },
    {
      "id": "40740",
      "slug": "cafes-moulus",
      "label": "Cafés moulus",
      "level": 3
    }
  ],
  "nutriscore": null,
  "more_offers": {
    "count": 0,
    "best_offer_id": null,
    "best_offer_price": null
  },
  "price_float": 4.99,
  "short_title": "Café Moulu Classique 100% Arabica Intensité 7 CARTE NOIRE",
  "business_type": "food",
  "is_best_seller": false,
  "price_per_unit": "9.98 € / KG",
  "customer_reviews": {
    "count": 2,
    "rates": null,
    "average": 5
  },
  "price_per_unit_float": 9.98,
  "price_per_unit_measure": "KG",
  "price_per_unit_currency": "€"
}
```

### Lookup Œufs de caille Le Gaulois

```json
{
  "brand": "GAULOIS",
  "image": "https://media.carrefour.fr/medias/ed17057cca61469e8b147748c864660b/p_1500x1500/03266980075934_A1N1_s01.png",
  "price": "3,75€",
  "title": "Œufs de caille LE GAULOIS",
  "currency": "€",
  "features": {
    "nom_legal": "Oeufs de cailles",
    "ingredients": "100% OEUF",
    "valeurs_nutritionnelles": {
      "matieres_grasses": "14 g / 100 g",
      "acides_gras_satures": "4.9 g / 100 g",
      "valeur_energetique_kj": "737 kJ / 100 g",
      "valeur_energetique_kcal": "178 kcal / 100 g"
    }
  },
  "packaging": "la boite de 18",
  "nutriscore": "B",
  "price_float": 3.75,
  "price_per_unit": "18.75 € / KG",
  "price_per_unit_float": 18.75,
  "price_per_unit_measure": "KG",
  "price_per_unit_currency": "€"
}
```

## Documentation

## Overview
Extract comprehensive product information from any Carrefour product page on carrefour.fr. Returns price, brand, images, Nutriscore, nutritional info, customer reviews, and categories.

## Quickstart
```
GET https://api.piloterr.com/v2/carrefour/product?query=https://www.carrefour.fr/p/oeufs-de-caille-le-gaulois-3266980075934
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Carrefour product page URL (carrefour.fr only) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `brand` | string | Product brand |
| `title` | string | Product title |
| `price_float` | number | Numeric price |
| `nutriscore` | string | Nutriscore grade |
| `customer_reviews.average` | number | Customer rating |
| `categories` | array | Category hierarchy |

## Notes
- Only carrefour.fr domain is supported.

## Main use cases
- Monitor Carrefour grocery pricing for retail intelligence
- Extract Nutriscore data to power food comparison platforms
- Enrich product databases with live Carrefour details
- Build price-tracking automation for FMCG products