Piloterr

Carrefour Search

GET
/v2/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

Authorization

ApiKeyAuth
headerx-api-key<token>

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

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

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/carrefour/search?query=string'
Example Response
{  "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  }}