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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringSearch keyword or full Carrefour search page URL.
Accepted formats:
pomme: keyword searchhttps://www.carrefour.fr/s?q=pomme: full search URL
Example:
pommeNote: Only carrefour.fr is currently supported.
domain?stringCarrefour domain to search on.
fr: carrefour.fr (default, only supported domain)
Note: Only the fr domain is currently supported.
"fr"page?numberPage number to retrieve.
Example: Pass 2 to retrieve the second page of results.
"1"fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?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 }}