Carrefour API

Not for carrefour.fr data, as of November 2026. Carrefour does not publish a public product, price or store API for carrefour.fr. Its developer portal serves Carrefour Italia partners (the Italian stores were sold to NewPrinces, closing December 1, 2025), Carrefour Links serves brands and suppliers with data collaboration, and marketplace sellers sync their own offers through Mirakl. The France developer portal some AI answers link does not resolve as of November 12, 2026. The Scavio Carrefour API is a separate option: 9 POST endpoints that return what carrefour.fr shows today as JSON.

carrefour.fr prices depend on the store. Without store, the API returns carrefour.fr's national online price; with store set to a store ref, it returns that store's shelf price and that store's range. The response always says which, in store and price_scope. On 2026-11-12 the Nutella 400 g jar was 3.99 national, 3.69 at two stores and 4.61 at a third, and "lait" returned about 599 results nationally against 147 at one store.

From /api/v1/carrefour/stores (store_ref or any pickup_refs[].ref, by French postal code or lat and lng) or from /api/v1/carrefour/store-availability (stores[].store.ref for the stores near a postal code that carry an EAN). Pass it as store to search, product, category or promotions. An unknown ref is a charged 404, so take refs from those endpoints. Carrefour Store Locator API docs

Yes. Every item has unit_price, unit (KG or L) and unit_price_label as carrefour.fr computes it, for example 9.98 € / KG for the 400 g Nutella jar at 3.99. Search and category can sort by it with unit_price_low_to_high and unit_price_high_to_low.

Each promotion has type, the label as the site writes it ("Le 2ème à -50%", "-10% Club", "PROMO : 30%", "Vu en catalogue"), loyalty_only (true when the price needs the Carrefour loyalty card: a member price), seen_in_catalogue, discounted_price and initial_price for the promotion's quantity when the site prices them, discount_amount, quantity, starts_at and ends_at. A multi-buy has no single discounted unit price: "Le 2ème à -50%" on the 400 g jar reads 5.98 for two instead of 7.98. Deals the site does not price return discounted_price null. The promotions endpoint lists all, catalogue, immediate, loyalty or the seasonal festive selection.

Yes, as carrefour.fr publishes them. product returns nutriscore (A-E, null when the site shows none), ecoscore, the ingredient list, allergens (the words the site writes in capitals in the ingredients that name an EU regulated allergen, as written there) and nutrition per 100 g or ml and per portion. Listings carry Nutri-Score and Eco-Score per item where the listing has them (product is the fuller source), and search and category filter by Nutri-Score. Check the pack label for health or allergy decisions.

Because carrefour.fr is written in French. Titles, ingredients, nutrient names, facet labels and promotion labels come back exactly as the site writes them ("Pâte à Tartiner Noisettes Cacao NUTELLA"); Scavio does not translate them. Argentina returns Spanish, Romania Romanian, and Belgium French or Dutch through language.

carrefour.fr (France, EUR) has every endpoint. Search and product also serve carrefour.com.ar (Argentina, ARS, Spanish), carrefour.ro (Romania, RON, Romanian) and carrefour.be (Belgium, EUR, French or Dutch) through country. Filters, facets, store prices, reviews, promotions, stores and fuel prices are France only. Carrefour's Spain, Italy, Poland and Brazil sites and the Middle East stores run by the Majid Al Futtaim franchise are not covered.

Yes, per station. Find stores with a station through /api/v1/carrefour/stores with service station_service, then call /api/v1/carrefour/store with the store's slug: fuel lists Gazole, SP95, SP95-E10, SP98, E85 and GPLc per litre where the station sells them, each with its update time. Stores without a station return fuel null.

Yes, for carrefour.fr. /api/v1/carrefour/reviews returns 1 to 50 reviews per call by EAN, sorted most recent, oldest, highest or lowest rated, with a star filter and offset paging. Each review has the author as published (first name and last initial), rating, title, text, review date, purchase date and the verified-review source. The product endpoint carries the average and the star distribution. Carrefour Reviews API docs

Yes or no, not a count. /api/v1/carrefour/store-availability checks the stores around a French postal code for one EAN and returns available per store, with distance, hours and the store ref. It returns no price and no unit count; for a store's price, pass its ref as store to search or product.

No. Every endpoint returns today's prices and promotions. A Carrefour price tracker builds its own history by polling on a schedule and storing what it saw. carrefour.fr's own terms note that information "peut nécessiter une mise à jour qui a pu ne pas intervenir à la date de leur consultation" (Art. 38), which is one more reason to record the price and the time yourself.

Black Friday is Friday, November 27, 2026, and carrefour.fr's Black Friday page reads "Jusqu'au 30 novembre". Snapshot the promotions lists and your watchlist several times a day through that window and store each snapshot: the API returns the offer at the moment of the call. Monitoring only: Scavio never places orders.

carrefour.fr's terms of use (updated March 6, 2020) say access to the site is free ("L'accès au Site est libre", Art. 13) and prohibit extracting or reusing its databases "sans l'autorisation préalable expresse de Carrefour France" (Art. 49); Art. 44 covers site content including photographs. Scavio returns publicly shown carrefour.fr data, does not sign in to customer accounts and never places orders. This is not legal advice: check the terms and your own counsel for your use case.

1 credit per call on every endpoint, including store-scoped calls; search and product on Belgium cost 2. New accounts get 50 free credits on signup, one time and with no card. On the Growth plan ($1 per 1,000 credits) that is $1 per 1,000 Carrefour calls. Failed upstream calls are not charged; a not-found (an unknown EAN, store ref or page) is charged.

Every request reads the Carrefour site when you call it and carries fetched_at; nothing is cached. In our captures most calls answered in 0.4 to 1.5 seconds; a store-scoped search took 2.9 seconds and a store page 6.2 seconds. Upstream checks sometimes fail; they are retried automatically, and a call that still fails is a 502 that is not charged.

No. The API returns the public price and the published promotions, with loyalty_only marking a member price. It never reads a Carrefour loyalty account, its balance or personal offers, does not book drive or delivery slots (store shows the next slot as the page displays it), has no cart or checkout, and returns no product Q&A or printed leaflet.