Carrefour France product
One Carrefour product: everything in search plus the description, regulated name, ingredients, allergens, the nutrition table per 100 g/ml and per portion, Eco-Score, storage advice, origin, characteristics and specifications, warranty and energy class for non-food, the rating distribution, every offer (Carrefour and marketplace sellers), variants, all images and categories.
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 |
|---|---|---|
idrequired | string | The product's barcode (EAN, e.g. 3428274200273) or its carrefour.fr/p/<name>-<barcode> link. Example: 3428274200273 |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/carrefour/v1/product?id=3428274200273" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/carrefour/v1/product",
params={"id": "3428274200273"},
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/product");
url.searchParams.set("id", "3428274200273");
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)
{"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","short_name": "Lait Demi-Ecrémé UHT Vitamine D LACTEL","description": "Le lait Lactel stérilisé UHT enrichi en vitamine D, est le lait de toute la famille. Partenaire idéal d'un petit déjeuner équilibré, il part…","regulated_name": "Lait demi-écrémé enrichi en vitamine D stérilisé UHT","ingredients": "LAIT demi-écrémé (origine : France), vitamine D","allergens": null,"additives": null,"nutrition": [{"per": "100","values": [{"name": "valeur énergétique (kJ)","quantity": "193 kJ","daily_contribution": null},{"name": "valeur énergétique (kcal)","quantity": "46 kcal","daily_contribution": null},"… 8 more"]}],"ecoscore": null,"storage": "Après ouverture, à conserver au froid (6°C max) et à consommer rapidement (sous 3 jours)","…": "19 more fields","cached": false,"credits_used": 1}