Carrefour API

Search carrefour.fr and get grocery prices, promotions, Nutri-Score and nutrition as clean JSON.

The API.SH Carrefour API returns public carrefour.fr product data as structured JSON. Search the French shop with its own filters (brand, promotions, organic, Carrefour brands, new, Nutri-Score, rating, size) and sorts (price, unit price, rating), browse any department or category, and open a product by its barcode for the price, unit price, promotions with start and end dates, ingredients, allergens, the nutrition table, Eco-Score, storage advice, origin, rating breakdown and every seller's offer.

Get a free API key Try it in the playground

4 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Search Carrefour France products

GET https://api.api.sh/carrefour/v1/search

{"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}

1 credit · $1 per 1,000 calls

What you can build with the Carrefour API

French grocery price tracking

Run the same searches or category pages every day and record price, unit price and promotion changes for the products and brands you follow.

/search /category

Promotion and loyalty offer monitoring

Filter searches and categories to products on promotion and collect each offer's type, discounted price and validity dates.

/search /category

Nutrition and Nutri-Score datasets

Open products by barcode to collect ingredients, allergens, the nutrition table per 100 g and per portion, Nutri-Score and Eco-Score for food apps or research.

/product

Assortment and brand share analysis

Walk the department tree and page through each category to see which brands and Carrefour own-label lines are listed, with their ratings and prices.

/categories /category

Barcode lookups for price comparison

Look up an EAN you already have and get the current carrefour.fr price, unit price, availability and marketplace offers for comparison with other retailers.

/product

Carrefour data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Carrefour France categories/carrefour/v1/categories

count1

categories[]id · name · path · level · url · children

Carrefour France category products/carrefour/v1/category

idcremerie/laitsurlhttps://www.carrefour.fr/r/creme…nameLaits et Boissons végétalespage1total308max_page11limit30count30next_page2

breadcrumb[]id · name · path

applied_filters[]sort · page

facets[]field · label · type · values

products[]id · ean · url · name · brand · packaging · format · offer_id · seller · marketplace · price · currency

Carrefour France product/carrefour/v1/product

id3428274200273ean3428274200273urlhttps://www.carrefour.fr/p/lait-…nameLait Demi-Ecrémé UHT Vitamine D …brandLACTELpackagingle pack de 12 bouteilles de 1Lformat12x1loffer_id0261-150-6sellerCarrefourmarketplacefalseprice11.99currencyEURunit_price1unitLunit_price_text1.00 € / Lavailabletruelow_stockfalsemax_quantity10

promotions[]type · label · loyalty · crossed_price · catalogue · quantity · discount · discounted_price · initial_price · start · end

nutrition[]per · values

Carrefour API endpoints and prices

Every Carrefour endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Search Carrefour France products

/carrefour/v1/search

params q +4 optionaldocstry

$1 · $2 PAYG

1 credit

Products, listings and places3

Carrefour France categories /carrefour/v1/categories params none required +1 optionaldocs try	$1 · $2 PAYG 1 credit
Carrefour France category products /carrefour/v1/category params id +4 optionaldocs try	$1 · $2 PAYG 1 credit
Carrefour France product /carrefour/v1/product params iddocs try	$1 · $2 PAYG 1 credit

Call the Carrefour API

Search Carrefour France products: GET https://api.api.sh/carrefour/v1/search

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();

# Google Sheets (API.SH add-on)
=APISH("/carrefour/v1/search", "q", "lait")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Carrefour" and "Search Carrefour France products".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 910 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Carrefour data

Public data only: no Carrefour login, cookies or account needed
One key and one response shape for Carrefour and 909 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
No rate limits: run as many calls in parallel as you need
Live status for every endpoint

API.SH vs the official Carrefour API

Carrefour runs API portals for some countries and units (an Italian developer portal, a Carrefour Banque portal) and shares retail data with brand partners through Carrefour Links, but there is no open, self-serve API for carrefour.fr product and price data. API.SH needs no partner account and returns the public shop data as JSON.

Instead of maintaining a carrefour.fr scraper or an Octoparse template, or picking among Apify actors built for other Carrefour countries, use one API.SH key with the same JSON shape across supermarkets such as Carrefour, Tesco, ASDA and Coles.

Carrefour API questions

What Carrefour data can I get?+

Product search with the shop's filters and sorts (/carrefour/v1/search), the department and category tree (/carrefour/v1/categories), category listings (/carrefour/v1/category) and one product by barcode with prices, promotions, Nutri-Score, ingredients, nutrition, rating breakdown and offers (/carrefour/v1/product).

How much does the Carrefour API cost?+

Every Carrefour endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /carrefour/v1/categories at 1 credit each.

Is there an official Carrefour API?+

Carrefour has developer and partner portals in some countries and for its bank, and a data platform for brands (Carrefour Links), but no open public API for carrefour.fr products and prices. API.SH covers that with public data only.

Do I need a Carrefour account or login?+

No. API.SH reads public carrefour.fr pages only. No endpoint uses a Carrefour account or loyalty card, and no personal data is involved.

How do I get started?+

Sign up at api.sh, copy your API key and call /carrefour/v1/search?q=lait. The docs at https://api.sh/docs show every parameter with a live example; there are SDKs, plus Google Sheets, Zapier, Make, n8n and an MCP server at https://api.sh/mcp.

How do I get the price of a Carrefour product?+

Call /carrefour/v1/product with the product's barcode (EAN) or its carrefour.fr link. The answer includes the price, unit price, any promotion with its discounted price and dates, and availability. Search results carry the price too.

Does it cover Carrefour in other countries?+

These endpoints cover Carrefour France (carrefour.fr) with national online prices. Carrefour shops in Spain, Italy, the UAE and other countries are separate sites and are not part of this API.

Does the Carrefour API have a rate limit?+

No. API.SH puts no rate limit on your key: send as many Carrefour calls in parallel as you need and pay only for the calls that run. If Carrefour itself slows down, the call returns 503 with a retry-after header and is not charged.