Auchan API & Scraper
Auchan France prices are set per store: on 2026-10-18, 28 of the 28 coffee products sold at both the Lille-Lezennes drive and the Marseille Saint-Loup drive had a different price there, in the same minute, and the same search for milk listed 292 products at one drive and 667 at the Kremlin-Bicêtre hypermarket.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
auchan.fr shows no price at all until a store is chosen, so every call names its store (store_id) and the answer says which store it was priced for. `search`, `category` and `promotions` return 30 products per page with the price charged now, the struck-through old price and discount on an immediate reduction, the unit price per kg, litre or piece, the store's stock figure, multi-buy offers ('-40% sur le 2ème', '3 achetés = 2 payés') and the Waaoh loyalty offer ('25 % cagnottés') as separate fields, rating, review count, labels and the site's sponsored products in their own list. `product` returns one product in full: EAN, Auchan reference, Nutri-Score, the nutrition table per 100 g/ml, ingredients, allergens, characteristics such as origin and legal name, category path and all images. `stores` lists Auchan drives, click & collect points and lockers near a French postcode, and `categories` the aisle tree.
What an Auchan field actually contains
Fields that read differently from how they look. Every row was measured against live auchan.fr responses on 2026-10-18.
| Field | What it holds |
|---|---|
| store, store_defaulted | The store the prices, assortment and stock belong to. Without store_id the answer is priced for Auchan Drive Hypermarché Kremlin-Bicêtre (store 975) and store_defaulted is true. |
| price | The price charged now for one unit at that store. Pampers Baby Dry size 3 (104): 19.00. |
| was_price, discount_percent, regular_price | An immediate reduction prints the old price struck through: was_price 28.79, discount_percent 34. regular_price is was_price when there is one, otherwise price. |
| loyalty_offer | Waaoh loyalty money ('25 % cagnottés', '40 % cagnottés sur le 2ème'): credited to the loyalty account, it never lowers price. |
| promotions[] | Every offer on the product: label, type (LOYALTY, RAW_DISCOUNT for multi-buy, IMMEDIATE), min_quantity (2 for 'sur le 2ème', 3 for '3 achetés = 2 payés') and percent. |
| unit_price, unit | The comparison price on the label: 1.11 per l, 11.79 per kg, 0.18 per pce. |
| stock_quantity | The store's stock figure shown with the add-to-cart button; 1 to 390 seen. |
| store_priced, seller_type, sold_by | Groceries are priced by the store (GROCERY). Non-food items are sold online or with 1-hour in-store pickup (ONLINE, STORE) at one national price: 29 of 29 high-tech products had the same price at three stores. |
| sponsored (list) | Products the site marks Sponsorisé inside its results, 0 to 4 per page, sometimes repeating a product listed normally. They never count in products or total. |
| nutriscore | A to E as the product page prints it, with nutriscore_new_calculation when the site says Nouveau calcul. Shown on part of the food range only. |
Prices are in euros including VAT, as on auchan.fr. Coupons the site adds in the browser are not in the data.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/auchan/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "lait",
"store_id": "823"
}
}{
"ok": true,
"meta": {
"api": "auchan",
"endpoint": "search",
"mode": "live",
"latency_ms": 1486.4,
"record_count": 29,
"bytes": 594825,
"cache_hit": false,
"banners_dropped": 1,
"source_url": "https://www.auchan.fr/recherche?text=lait",
"journey": "cached",
"upstream_requests": 1,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "554a92908d10428d",
"queue_ms": 1.2,
"fetched_at": "2026-10-18T17:44:57.167Z"
},
"data": {
"products": [
{
"product_id": "C1306935",
"uuid": "eaa42e9f-3dd0-43be-89ad-2f0895517f20",
"offer_id": "3bf29123-dd23-57a6-ab0f-9a42de807958",
"name": "AUCHAN SOLIDAIRES BIO CULTIVONS LE BON Lait demi-écrémé UHT",
"brand": "AUCHAN SOLIDAIRES BIO",
"title": "CULTIVONS LE BON Lait demi-écrémé UHT",
"url": "https://www.auchan.fr/auchan-solidaires-bio-cultivons-le-bon-lait-demi-ecreme-uht/pr-C1306935",
"image": "https://cdn.auchan.fr/media/P02000000000NJOPRIMARY_0x0/B2CD/",
"pack_size": "6x1L",
"price": 6.63,
"regular_price": 6.63,
"was_price": null,
"discount_percent": null,
"currency": "EUR",
"unit_price": 1.11,
"unit": "l",
"promotions": [],
"loyalty_offer": null,
"availability": "InStock",
"stock_quantity": 2,
"delivery_promise": "Dans mon drive",
"seller_type": "GROCERY",
"sold_by": null,
"offer_count": 1,
"store_priced": true,
"rating": 4.6,
"review_count": 260,
"new": false,
"sponsored": false,
"labels": [
"Eurofeuille - Bio européen",
"AB Agriculture biologique",
"Filières Responsables Auchan Cultivons le Bon"
],
"priced": true,
"position": 1,
"rank": 1
},
{
"product_id": "C1170327",
"uuid": "0dd7d635-7c35-4ace-ad0e-6ae131df97cf",
"offer_id": "e467904d-a39b-5378-a45c-0001097628ad",
"name": "AUCHAN Lait demi-écrémé UHT Hauts-de-France",
"brand": "AUCHAN",
"title": "Lait demi-écrémé UHT Hauts-de-France",
"url": "https://www.auchan.fr/auchan-lait-demi-ecreme-uht-hauts-de-france/pr-C1170327",
"image": "https://cdn.auchan.fr/media/P020000000006HBPRIMARY_0x0/B2CD/",
"pack_size": "6x50cl",
"price": 4.8,
"regular_price": 4.8,
"was_price": null,
"discount_percent": null,
"currency": "EUR",
"unit_price": 1.6,
"unit": "l",
"promotions": [],
"loyalty_offer": null,
"availability": "InStock",
"stock_quantity": 10,
"delivery_promise": "Dans mon drive",
"seller_type": "GROCERY",
"sold_by": null,
"offer_count": 1,
"store_priced": true,
"rating": 4.7,
"review_count": 92,
"new": false,
"sponsored": false,
"labels": [
"Format"
],
"priced": true,
"position": 2,
"rank": 2
},
{
"product_id": "C1177651",
"uuid": "2bb983c8-05c9-4c3c-b752-6ec5b77865f7",
"offer_id": "6a5c1278-a88a-5070-bfe1-d26177d8a5b3",
"name": "POUCE Lait demi-écrémé UHT",
"brand": "POUCE",
"title": "Lait demi-écrémé UHT",
"url": "https://www.auchan.fr/pouce-lait-demi-ecreme-uht/pr-C1177651",
"image": "https://cdn.auchan.fr/media/A0220050207000014460PRIMARY_0x0/B2CD/",
"pack_size": "6x1L",
"price": 5.52,
"regular_price": 5.52,
"was_price": null,
"discount_percent": null,
"currency": "EUR",
"unit_price": 0.92,
"unit": "l",
"promotions": [],
"loyalty_offer": null,
"availability": "InStock",
"stock_quantity": 62,
"delivery_promise": "Dans mon drive",
"seller_type": "GROCERY",
"sold_by": null,
"offer_count": 1,
"store_priced": true,
"rating": 4.5,
"review_count": 212,
"new": false,
"sponsored": false,
"labels": [],
"priced": true,
"position": 3,
"rank": 3
}
],
"sponsored": [],
"total": 292,
"total_is_exact": true,
"pagination": {
"page": 1,
"last_page": 10,
"has_more": true
},
"store": {
"store_id": "823",
"name": "Auchan Drive Villeneuve D'Ascq (Lezennes)",
"type": "DRIVE",
"postal_code": "59650",
"city": "LEZENNES"
},
"store_defaulted": false,
"query": {
"page": 1,
"sort": "relevance",
"query": "lait"
}
}
}What the Auchan API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search auchan.fr by keyword for one store, with the site's sorts and filters (promotion, Waaoh loyalty offer, new, Nutri-Score, rating). 30 products per page, priced for the store. | Pricing teams call search to search auchan.fr by keyword for one store, with the site's sorts and filters (promotion, Waao…. | query, store_id, page, sort, on_promotion, ... |
| category | List one Auchan category (aisle) for one store, with the same sorts and filters as search. | Marketplace operators call category to list one Auchan category (aisle) for one store, with the same sorts and filters as search.. | category_id, store_id, page, sort, on_promotion, ... |
| promotions | The current promotions of one store (the site's 'Promos' shop): immediate reductions, multi-buy offers and Waaoh loyalty offers, 30 products per page. | Catalog enrichment teams call promotions to get the current promotions of one store (the site's 'Promos' shop). | store_id, page, sort, loyalty_offer, new_only, ... |
| product | One Auchan product in full for one store: price, old price and discount, unit price, promotions and Waaoh offer, stock, EAN, Auchan reference, Nutri-Score, nutrition table, ingredients, allergens, characteristics (origin, legal name, storage…), category path, images, rating and review count. | Retail analysts call product to get one Auchan product in full for one store. | product_id, store_id |
| stores | Auchan pickup stores (drives, click & collect points, lockers) near a French postcode or a point, nearest first, with the store_id the other actions take, address, distance, type and opening hours. | Pricing teams call stores to get auchan pickup stores (drives, click & collect points, lockers) near a French postcode or a po…. | postal_code, latitude, longitude |
| categories | Auchan's aisles: the top-level navigation ('Nos rayons'), or the sub-categories of one category with category_id. | Marketplace operators call categories to get auchan's aisles. | category_id |
Call search from your stack
curl -X POST https://api.reefapi.com/auchan/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"lait","store_id":"823"}'import requests
r = requests.post(
"https://api.reefapi.com/auchan/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "lait",
"store_id": "823"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/auchan/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "lait",
"store_id": "823"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.auchan.search with {"query":"lait","store_id":"823"}.Who uses this API and why
- Compare Auchan drive prices between stores and against Carrefour and E.Leclerc.
- Track Auchan promotions, multi-buy offers and Waaoh loyalty offers week by week.
- Build a French grocery product database with EAN, Nutri-Score and nutrition values.
- Watch the unit price per kg or litre of a basket at the drive your customers use.
- Map Auchan drives, click & collect points and lockers around a set of postcodes.
Questions developers ask before integrating
Do I need an Auchan account or a Waaoh loyalty card?
No. The data is what a visitor sees on auchan.fr after choosing a store: prices, promotions, Waaoh offers, stock and product sheets.
How do I get prices for my local Auchan drive?
Call stores with a French postcode (for example 59000), take the store_id of the drive, click & collect point or locker you want, and pass it to search, category, promotions or product.
Do prices really differ between Auchan stores?
Yes. On 2026-10-18 milk at the Lille-Lezennes drive and the Marseille Saint-Loup drive differed on 16 of the 23 products sold at both; coffee on 28 of 28. Assortment differs too: 292 milk products at one drive, 667 at the Kremlin-Bicêtre hypermarket.
Is the Waaoh cagnotte included in the price?
No. The Waaoh offer is money credited to the loyalty account, so it is returned in loyalty_offer and promotions and price stays the till price.
Can I get the EAN and Nutri-Score?
product returns the EAN and Auchan's own reference for every product checked (12 of 12), the Nutri-Score when the product page shows one, plus the nutrition table, ingredients and allergens for food.
Which filters and sorts work?
on_promotion (milk: 292 to 27), loyalty_offer (3), new_only (19), nutriscore a to e (18 for A), min_rating (250 at 4 stars and more) and sorts by price, unit price, rating, brand and 7-day best sellers. Each was checked against the unfiltered result.
How many products can I page through?
30 per page; milk at one drive ran to 10 pages, with no product repeated across pages 1 to 3. A page past the last one returns no product.
How fresh is the data?
Every call reads auchan.fr live; nothing is cached.
What is the Auchan API?
Auchan API is a ReefAPI endpoint group for auchan france drive prices by store: search, aisles, promotions, waaoh offers, ean and nutri-score, store finder. It returns live JSON through POST requests under /auchan/v1.
Is the Auchan API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Auchan calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Auchan login or account?
No login to Auchan is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Auchan data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Auchan API use?
Auchan actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Auchan from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call auchan actions with the same key, credit pool and JSON envelope used by normal REST requests.