# Carrefour Search

## Overview

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

## Description

Search for products on Carrefour by keyword or URL, returning structured listings with prices, ratings, and pagination.

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

## Example Response

### Search for pasta (panzani)

```json
{
  "results": [
    {
      "id": "3038350023605",
      "slug": "pates-torti-panzani-3038350023605",
      "image": "https://media.carrefour.fr/medias/b55716bc4b4a43abae8126835fdda61e/p_200x200/03038350023605_H1N1_s01.png",
      "price": "1,95€",
      "title": "Pâtes torti PANZANI",
      "rating": 4.5,
      "currency": "€",
      "sponsored": false,
      "price_float": 1.95,
      "reviews_count": 523
    },
    {
      "id": "3038350013507",
      "slug": "pates-coudes-rayes-panzani-3038350013507",
      "image": "https://media.carrefour.fr/medias/7aadb8b182ed458c919dca3b560d82a2/p_200x200/03038350013507_H1N1_s01.png",
      "price": "1,19€",
      "title": "Pâtes coudes rayés PANZANI",
      "rating": 4.5,
      "currency": "€",
      "sponsored": false,
      "price_float": 1.19,
      "reviews_count": 400
    },
    {
      "id": "3038350023001",
      "slug": "pates-coquillettes-panzani-3038350023001",
      "image": "https://media.carrefour.fr/medias/22a129b9d98d4254ae50af77adb0aa14/p_200x200/03038350023001_H1N1_s01.png",
      "price": "1,95€",
      "title": "Pâtes coquillettes PANZANI",
      "rating": 4.5,
      "currency": "€",
      "sponsored": false,
      "price_float": 1.95,
      "reviews_count": 702
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "has_next_page": true
  }
}
```

## Documentation

## Overview
Search for products on Carrefour (carrefour.fr) by keyword or URL. Returns paginated product listings with prices, ratings, and slugs for the Product API.

## Quickstart
```
GET https://api.piloterr.com/v2/carrefour/search?query=pomme&domain=fr
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search keyword or Carrefour search URL |
| `domain` | string | no | Domain (`fr` only) |
| `page` | integer | no | Page number (default: 1) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].slug` | string | Product slug for the Product API |
| `results[].price_float` | number | Numeric price |
| `results[].rating` | number | Customer rating |
| `pagination` | object | Pagination metadata |

## Main use cases
- Discover and catalog all Carrefour products by keyword
- Monitor grocery pricing for retail intelligence
- Feed product discovery pipelines with Carrefour search
- Build price alert systems with regular scraping