Piloterr

Carrefour Search

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

Credit cost: 2 credits per call

GET
/v2/carrefour/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Search keyword or full Carrefour search page URL.

Accepted formats:

  • pomme — keyword search
  • https://www.carrefour.fr/s?q=pomme — full search URL

Example:

pomme

Note: Only carrefour.fr is currently supported.

domain?string

Carrefour domain to search on.

  • fr: carrefour.fr (default, only supported domain)

Note: Only the fr domain is currently supported.

Default"fr"
page?number

Page number to retrieve.

Example: Pass 2 to retrieve the second page of results.

Default"1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/carrefour/search?query=string"
{
  "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
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}