Carrefour France category products
GET https://api.api.sh/carrefour/v1/category
The products of one Carrefour category, 30 a page, with the same fields, filters, sorts and facets as search, plus the category's breadcrumb. 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 |
|---|---|---|
idrequired | string | A category path (e.g. cremerie/laits) or a carrefour.fr/r/<path> link. Example: cremerie/laits |
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 ';'. |
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/category?id=cremerie%2Flaits" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/carrefour/v1/category",
params={"id": "cremerie/laits"},
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/category");
url.searchParams.set("id", "cremerie/laits");
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": "cremerie/laits","url": "https://www.carrefour.fr/r/cremerie/laits","name": "Laits et Boissons végétales","breadcrumb": [{"id": "36993","name": "Crèmerie et Produits laitiers","path": "cremerie"},{"id": "29297","name": "Laits et Boissons végétales","path": "cremerie/laits"}],"applied_filters": {"sort": "relevance","page": 1},"page": 1,"total": 308,"max_page": 11,"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": 92}]},"… 12 more"],"products": [{"id": "3428273990083","ean": "3428273990083","url": "https://www.carrefour.fr/p/lait-sans-lactose-uht-12-mg-matin-leger-lactel-3428273990083","name": "Lait Sans Lactose UHT 12% MG Matin Léger LACTEL","brand": "LACTEL","packaging": "le pack de 6 bouteilles de 1L","format": "6x1L","offer_id": "0261-150-6","seller": "Carrefour","marketplace": false,"price": 10.68,"currency": "EUR","unit_price": 1.78,"unit": "L","unit_price_text": "1.78 € / L","available": true,"low_stock": false,"max_quantity": 10,"label": null,"promotions": [],"new": false,"freshness_days": 10,"rating": 4.67,"review_count": 870,"nutriscore": null,"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/58bd33b38b4c4c55839f61536a8ce22d/p_540x540/03428273990083_H1L1_s02.png"},{"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"},"… 28 more"],"cached": false,"credits_used": 1}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.