Search Carrefour France products
Carrefour (carrefour.fr, France) product search, 30 a page: barcode (EAN), link, name, brand, packaging and format, price, unit price, availability, purchase limit, promotions (type, discounted price, start and end dates), loyalty offers, rating and review count, Nutri-Score, best-seller flag, number of other sellers' offers, category path and image. facets lists the shop's filters for the query (brand, promotions, organic, Carrefour brands, new, lactose free, Nutri-Score, rating, size...) with their field, values and counts: pass them in filters. Pass next_page back as page; null on the last page.
Every response includes credits_used: the credits this call cost.
Part of the Carrefour API: 4 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
qrequired | string | Search keywords (French works best). Example: lait |
sort | relevance | price_asc | price_desc | unit_price_asc | unit_price_desc | rating | relevance (default), price_asc, price_desc, unit_price_asc, unit_price_desc, rating. |
filters | string | Facet filters as field:value pairs separated by ';', with the field and a value from facets (e.g. facet_marque:LACTEL;product.flags.is_organic:true). |
promotions | boolean | true for products on promotion only. |
page | integer | Page number, 1 for the first, up to 99. Pass back next_page. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/carrefour/v1/search?q=lait" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/carrefour/v1/search",
params={"q": "lait"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/carrefour/v1/search");
url.searchParams.set("q", "lait");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"query": "lait","applied_filters": {"sort": "relevance","page": 1},"page": 1,"total": 595,"max_page": 20,"limit": 30,"count": 30,"next_page": 2,"corrected_query": null,"sort_options": ["relevance","price_asc","… 4 more"],"facets": [{"field": "offers.is_new","label": "Nouveauté","type": "boolean","values": [{"value": "true","count": 2}]},{"field": "ES_discount_quickaccess","label": "Promotions","type": "boolean","values": [{"value": "true","count": 175}]},"… 13 more"],"products": [{"id": "3428274200273","ean": "3428274200273","url": "https://www.carrefour.fr/p/lait-demi-ecreme-uht-vitamine-d-lactel-3428274200273","name": "Lait Demi-Ecrémé UHT Vitamine D LACTEL","brand": "LACTEL","packaging": "le pack de 12 bouteilles de 1L","format": "12x1l","offer_id": "0261-150-6","seller": "Carrefour","marketplace": false,"price": 11.99,"currency": "EUR","unit_price": 1,"unit": "L","unit_price_text": "1.00 € / L","available": true,"low_stock": false,"max_quantity": 10,"label": "Vu en catalogue","promotions": [{"type": "ta","label": "Vu en catalogue","loyalty": false,"crossed_price": false,"catalogue": true,"quantity": 1,"discount": 0,"discounted_price": 11.99,"initial_price": 11.99,"start": "2026-10-22T00:00:00+0200","end": "2026-11-09T23:59:00+0100"}],"new": false,"freshness_days": 10,"rating": 4.72,"review_count": 2509,"nutriscore": "A","best_seller": false,"business_type": "food","other_offers": 0,"category": "Crèmerie et Produits laitiers > Laits et Boissons végétales > Lait demi-écrémé","category_path": "cremerie/laits/lait-demi-ecreme","image": "https://media.carrefour.fr/medias/da433fbba1023dce94dc3080183349c8/p_540x540/03428274200273-c1l1-s01.jpg"},{"id": "3276554163158","ean": "3276554163158","url": "https://www.carrefour.fr/p/lait-demi-ecreme-carrefour-classic-3276554163158","name": "Lait Demi-Écrémé CARREFOUR CLASSIC'","brand": "CARREFOUR CLASSIC'","packaging": "la bouteille 1L","format": "1L","offer_id": "0261-150-6","seller": "Carrefour","marketplace": false,"price": 1.05,"currency": "EUR","unit_price": 1.05,"unit": "L","unit_price_text": "1.05 € / L","available": true,"low_stock": false,"max_quantity": 50,"label": null,"promotions": [],"new": false,"freshness_days": 10,"rating": 4.72,"review_count": 164,"nutriscore": "A","best_seller": false,"business_type": "food","other_offers": 0,"category": "Crèmerie et Produits laitiers > Laits et Boissons végétales > Lait demi-écrémé","category_path": "cremerie/laits/lait-demi-ecreme","image": "https://media.carrefour.fr/medias/6236a56cbc6c46c4a47aaeea5b9ffe0b/p_540x540/3276554163158-photosite-20241112-171948-0.jpg"},"… 28 more"],"cached": false,"credits_used": 1}