carrefour.fr APIcarrefour.fr ↗
Access Carrefour.fr grocery data via 4 endpoints: search products, retrieve full product details, browse categories, and find store locations.
curl -X GET 'https://api.parse.bot/scraper/a7ed411e-b2aa-462d-a179-bb55f7aaae1e/search_products?query=lait' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword query on Carrefour.fr. Returns a list of products with pricing, packaging, and review information.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'lait', 'pain', 'fromage') |
{
"type": "object",
"fields": {
"total": "integer — number of products returned",
"products": "array of product objects with ean, title, brand, slug, image, price, packaging, format, nutriscore, customer_reviews"
},
"sample": {
"data": {
"total": 15,
"products": [
{
"ean": "3428273990083",
"slug": "lait-sans-lactose-uht-12-mg-matin-leger-lactel",
"brand": "LACTEL",
"image": "https://media.carrefour.fr/medias/58bd33b38b4c4c55839f61536a8ce22d/p_FORMAT/03428273990083_H1L1_s02.png",
"price": {
"unit": "L",
"price": 10.68,
"unit_price": 1.78,
"per_unit_label": "1.78 € / L"
},
"title": "Lait Sans Lactose UHT 12% MG Matin Léger LACTEL",
"format": "6x1L",
"packaging": "le pack de 6 bouteilles de 1L",
"nutriscore": null,
"customer_reviews": {
"count": 799,
"rates": {
"1": 0,
"2": 1,
"3": 2,
"4": 25,
"5": 72
},
"average": 4.67
}
}
]
},
"status": "success"
}
}About the carrefour.fr API
The Carrefour.fr API provides 4 endpoints for querying the French grocery retailer's product catalog, including pricing, nutrition facts, ingredients, and customer reviews. The get_product_details endpoint returns over 10 structured fields per product — EAN barcode, brand, unit price, full ingredients list, regulated name, and per-portion nutritional values — looked up by barcode. Two additional endpoints cover keyword search and category browsing across ranges like dairy, beverages, and produce.
Product Search and Browsing
The search_products endpoint accepts a French-language keyword via the query parameter (e.g., lait, fromage, pain) and returns a list of matched products. Each item in the response includes ean, title, brand, slug, image, price, packaging, format, nutriscore, and customer_reviews. The browse_category_products endpoint works similarly but accepts a category_slug like cremerie, boissons, epicerie-sucree, or fruits-et-legumes to return featured and promoted products within that category.
Full Product Detail Lookup
The get_product_details endpoint takes an EAN barcode as a required parameter and an optional slug for improved lookup reliability. The response covers commercial information — price (with unit_price, unit, and per_unit_label), title, brand, description — alongside regulatory and nutritional data: ingredients, regulated_name, nutrition (per-portion values), and a categories array with label, slug, and URI for each level of the product hierarchy. This is the most data-dense endpoint in the API.
Store Locations
The get_store_locations endpoint takes no inputs and returns an array of Carrefour store records. This is useful for mapping store presence or pairing product availability data with physical locations. The response shape is a flat stores array; detailed field documentation for individual store objects should be tested against live responses.
- Build a Nutri-Score filter tool using the
nutriscorefield returned bysearch_products - Compare unit prices across competing products in a category using
unit_pricefrombrowse_category_products - Populate a dietary tracker app with per-portion nutrition data from
get_product_details - Cross-reference EAN barcodes scanned in-store with full ingredient lists via
get_product_details - Aggregate customer review counts across dairy products using
customer_reviewsfrom category browsing - Map Carrefour store locations for a grocery delivery radius tool using
get_store_locations - Monitor price changes on specific products over time by polling
get_product_detailsby EAN
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Carrefour.fr have an official public developer API?+
What does `get_product_details` return beyond basic pricing?+
price (including unit_price and per_unit_label), the endpoint returns ingredients, regulated_name, description, a structured nutrition object with per-portion values, and a categories array that reflects the full product hierarchy on the site. The optional slug parameter can be passed alongside the EAN to improve lookup reliability when the EAN alone is ambiguous.Are product availability or stock levels included in responses?+
Does `search_products` support filtering by brand, Nutri-Score, or price range?+
query keyword with no built-in filter parameters. The nutriscore, brand, and price fields are present in the response, so filtering can be applied client-side. You can fork the API on Parse and revise it to add server-side filter parameters if needed.