carrefour.eu APIcarrefour.eu ↗
Access Carrefour European product catalog via API. Search by keyword or category, retrieve prices, stock status, Nutri-Score, and full nutritional data.
curl -X GET 'https://api.parse.bot/scraper/ff0c0252-2e26-4e1c-9bfc-f1f76f2d3c33/search_products?page=0&query=chocolat' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword or browse by category. Returns a paginated list of products with prices, stock availability, and basic details. Results are returned 36 per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number, 0-indexed. |
| query | string | Search keyword (e.g., 'lait', 'chocolat'). If omitted, browses the specified category. |
| category_id | string | Category ID to browse (e.g., 'ros002' for Crèmerie). Omitting returns all products. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"products": "array of product objects with product_id, name, brand, price, currency, image_url, url, package_info, price_per_unit, and availability",
"page_size": "integer number of results per page (36)",
"total_count": "integer total number of matching products"
},
"sample": {
"data": {
"page": 0,
"products": [
{
"url": "https://www.carrefour.be/fr/orangettes-chocolat-noir-150-g/06181989.html",
"name": "Orangettes Chocolat Noir 150 g",
"brand": "Carrefour Bio",
"price": 6.59,
"currency": "EUR",
"image_url": "https://cdn.carrefour.eu/420_06181989_T1.webp",
"product_id": "06181989",
"availability": 22,
"package_info": "La pièce",
"price_per_unit": "43,93 €/kg"
}
],
"page_size": 36,
"total_count": 1408
},
"status": "success"
}
}About the carrefour.eu API
The Carrefour.eu API gives developers access to two endpoints covering Carrefour's European online product catalog, returning pricing, stock availability, brand details, and full nutritional information. Use search_products to query or browse by category with paginated results of 36 products per page, or call get_product_details with a product URL to retrieve Nutri-Score grades, ingredient lists, and structured nutritional values.
Searching and Browsing Products
The search_products endpoint accepts a query string for keyword searches (e.g., 'lait', 'chocolat') or a category_id to browse a specific department such as Crèmerie ('ros002'). Results are 0-indexed via the page parameter, with each page returning up to 36 items. Each product object includes product_id, name, brand, price, currency, image_url, url, package_info, price_per_unit, and availability status. The total_count field tells you how many total matching records exist, so you can calculate how many pages to traverse.
Retrieving Product Details
The get_product_details endpoint takes the url field returned by search_products and returns a richer record for that product. This includes a freeform description covering ingredients and practical information, a nutri_score field with the letter grade (A–E) or null where unavailable, and a nutritional_info array of label/value pairs covering typical per-100g or per-serving breakdowns. The brand field is repeated here so detail records can be used independently of search results.
Coverage and Scope
The API covers Carrefour's European online storefront (carrefour.be/carrefour.eu domain). Category IDs map to Carrefour's internal taxonomy, so pairing category_id with a paginated loop over total_count is the practical way to enumerate a full category. Nutritional data and Nutri-Score are product-dependent — not all items carry this information, and the API reflects whatever is present on the product page.
- Monitor real-time price changes across product categories by polling
search_productswith a fixedcategory_id - Build a grocery comparison tool using
price_per_unitandpackage_infofrom search results - Aggregate Nutri-Score grades from
get_product_detailsacross a food category for nutrition research - Sync Carrefour product catalog data — names, brands, images, and prices — into an internal PIM system
- Track stock availability changes for specific products by regularly calling
search_productswith targeted keywords - Extract structured
nutritional_infoarrays for diet-planning or calorie-tracking applications - Identify promotional pricing by comparing
priceandprice_per_unitacross similar products in a category
| 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 have an official public developer API?+
What does `search_products` return when no `query` or `category_id` is provided?+
query and category_id are omitted, the endpoint returns a paginated list of products across the full catalog. To narrow results to a department, pass a category_id such as 'ros002' for Crèmerie. To search by keyword, pass a query string. Both parameters are optional and can be combined.Is nutritional data available for every product?+
nutri_score field returns null and nutritional_info may be empty for products where that information is not present on the product page. Coverage varies by product type — packaged food items typically include nutritional data, while non-food products generally do not.