E.Leclerc Scraper: Product Prices, Promotions, Stock and Ratings

E.Leclerc Scraper turns the E.Leclerc France grocery and general retail catalogue into a clean product data feed. Search by keyword or category, or paste product, category and search-result links, or bare EAN barcodes. Every product comes back as one flat record with title, description, images, price, unit price, a genuine promotion, stock and, where the storefront carries one, an aggregate rating, then export to JSON, CSV or Excel, or pull the results straight into your app through the API.

Why This Scraper?

• Two ways to find products. Search by keyword and/or category, then filter and sort the results, or paste product, category and search-result links, or bare EAN barcodes, mixed freely in one list.
• One flat record, one batched call. Title, description, images, price, promotion and stock all come from a single price call per product, always included, never gated behind an extra fetch. Unit price and brand come from search and category result pages, so a pasted product link or bare EAN does not carry them.
• Genuine promotions only. A "Ticket E.Leclerc" loyalty cashback, paid in full now and credited back later on the loyalty card, is reported separately and never disguised as a discounted price.
• Reproducible store attribution. Choose a store by postal code or an exact store sign code, and every record is stamped with it, so a run's results stay attributable and repeatable. Price and stock do not change by store, see the FAQ for how that was measured.
• Built for schedules. Incremental mode returns only new and changed products on recurring runs, and a run fails loudly instead of silently returning nothing when a store cannot be resolved.
• Resume and checkpoint protection. Continue one interrupted crawl with a pasted run id, and a long run picks up after the last completed keyword, category or link on a platform migration.
• Send results into the apps you use. Optional Notion, Linear, Airtable or Apify connectors, on top of the dataset, which is never changed by the export step.

Use Cases

• Grocery price monitoring: track price, promotion and stock changes for a shopping list of products on a recurring schedule.
• Category and catalogue research: pull a full category listing, for example laundry detergents, with ratings and unit prices for assortment analysis.
• Promotion tracking: filter for products currently on a genuine promotion, kept separate from loyalty cashback offers.
• Competitive and market intelligence: compare E.Leclerc's national price and promotion for a list of EANs against other retailers.
• Product catalogue enrichment: pull title, description, images and a category breadcrumb for a list of EANs to enrich an existing catalogue.

Data You Get

Sample shape: values are illustrative placeholders, not from a live record.

Field	Example
productId	"3700281702286"
ean	"3700281702286"
title	"ULTRA-HYDRATANT Lait Corps 500 ml"
brand	"Topicrem" (search and category results only, absent for a pasted product link or EAN)
description	"L'Ultra-Hydratant lait corps Topicrem est une emulsion onctueuse..."
images	["https://media.e.leclerc/3700281702286_1"]
categoryPath	"Cremes hydratantes > Topicrem > Les Essentiels"
price	11.04
unitPriceDisplay	"4.16 EUR / L" (search and category results only, absent for a pasted product link or EAN)
wasPrice	9.99 (only on a genuine promotion; the key is absent otherwise, never null)
discountAmount	1.5 (only on a genuine promotion; the key is absent otherwise, never null)
onPromotion	true
loyaltyCashbackPercent	30.0
loyaltyCashbackLabel	"Ticket E.Leclerc avec la carte"
inStock	true
stock	537
rating	4.8
reviewCount	28
storeSignCode	"1375"
storeName	"Montparnasse"
storePostalCode	"75014"
canonicalUrl	"https://www.e.leclerc/fp/ultra-hydratant-lait-corps-500-ml-3700281702286" (search and category results only, absent for a pasted product link or EAN)
searchMode	"search"
scrapedAt	"2026-09-15T08:00:00Z"

A record can also carry currency (always "EUR"), unitPrice and unitPriceUnit as the numeric parts of unitPriceDisplay (same search/category-only scope), discountPercent alongside discountAmount, availabilityStatus and warehouse from the price call, descriptionHtml alongside description, source ("listing" or "product", showing which kind of page the record was built from), promotionEndDate on any promotion including a loyalty cashback, promotionLabel on a non-loyalty promotion only, and an empty reviews array on any product that has a rating (individual review text is not available through the routes this actor uses). When Incremental mode is on, every record also carries changeType (NEW, UPDATED, UNCHANGED, REAPPEARED or EXPIRED), changedFields (populated only for UPDATED), firstSeenAt and lastSeenAt.

How to Use

1. Choose your store: enter a French postal code, or paste an exact store sign code copied from storeSignCode in a previous run's output. The run picks the nearest Hyper, Super or Express E.Leclerc store to a postal code.
2. Pick a mode: search (keywords and/or category links, with filters and sorting) or url (paste product, category or search-result links, or bare EAN barcodes).
3. Fill in the fields for that mode, and set Max products to control run size and cost.
4. Click Start. Download the dataset as JSON, CSV or Excel, or read it through the API.

Search by keyword:

{
  "postalCode": "75014",
  "mode": "search",
  "queries": ["lait"],
  "maxItems": 20
}

Browse a category, filtered to promotions in stock, cheapest first:

{
  "postalCode": "75014",
  "mode": "search",
  "categories": ["https://www.e.leclerc/cat/lessives-marque-repere"],
  "onPromotionOnly": true,
  "inStockOnly": true,
  "sortBy": "price_asc"
}

Paste product links and a bare EAN:

{
  "postalCode": "75014",
  "mode": "url",
  "urls": [
    "https://www.e.leclerc/fp/physiolac-lait-infantile-bio-1er-age-800g-3518646124167",
    "3700281702286"
  ]
}

Daily monitoring of the same store and search:

{
  "postalCode": "75014",
  "mode": "search",
  "queries": ["lait"],
  "incrementalMode": true
}

Run it from your code

Python:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("abotapi/leclerc-fr-scraper").call(run_input={"postalCode": "75014", "mode": "search", "queries": ["lait"]})
for product in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(product["title"], product.get("price"), product.get("onPromotion"))

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('abotapi/leclerc-fr-scraper').call({ postalCode: '75014', mode: 'search', queries: ['lait'] });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Or connect it to Make, Zapier, n8n, Google Sheets or webhooks from the Integrations tab.

Store selection and national pricing

Price, promotion and stock returned by this actor are the storefront's national reference offer: measured live against two deliberately distant stores, every one of 30 checked products came back identical, and an invalid store code returns the same response as a valid one. Choosing a store still matters because it stamps every record with storeSignCode, storeName and storePostalCode for a reproducible run, and because it keys the incremental baseline. If both Postal code and Store sign code are filled, Store sign code wins.

Resume and recurring updates

Two different things, pick the one that matches what you are doing.

Resume (resumeFromRunId) continues one specific interrupted or previous large crawl: paste a run id or dataset id and the run skips products already collected there. An automatic checkpoint also protects a long run against a platform migration without any input needed.

Incremental mode (incrementalMode) is for a recurring schedule over the same store and search: the actor remembers the previous run by itself, so no run id is pasted. The first run returns every product as NEW. Later runs return NEW and UPDATED products (changedFields lists what changed); unchanged products are suppressed and not billed unless emitUnchanged is on. A product is only classified REAPPEARED if an earlier run had Emit expired products on, completed a full scan of the tracked search, and marked that product EXPIRED, and this run finds it again. Without ever turning Emit expired products on, REAPPEARED is never produced. EXPIRED rows themselves are only added when Emit expired products is on and the run reached the natural end of every tracked search, not when Max products capped it and not on a Resume run. Set stateKey to name or deliberately share a monitoring campaign; a different store gets its own state automatically unless you set the same stateKey for both.

Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape: the Apify dataset is never changed.

What gets written to the connector: a condensed, human-readable summary of each product, not the full JSON. Each item becomes one entry with a title and its key fields flattened to plain text. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify, Settings, Integrations (Notion, Linear, Airtable, or Apify).
2. Select it in the "Pipe results into your apps" input field. If the picker is empty, you have not authorized a connector yet.
3. For Notion, also set notionParentPageUrl to the page where items should be created.

Leave the field empty to skip.

Input Parameters

Parameter	Type	Default	Description
postalCode	string	none (prefill: "75014")	A French postal code. The run picks the nearest Hyper, Super or Express store to it. One of postalCode or storeSignCode must be set for the run to start.
storeSignCode	string	none	Optional exact-store override. Wins over postalCode when both are set.
mode	string	"search"	search or url.
queries	array	none (prefill: ["lait"])	Search keywords (search mode).
categories	array	none	E.Leclerc category page links (search mode).
urls	array	none (prefill: ["https://www.e.leclerc/cat/lessives-marque-repere"])	Product links, bare EANs, category links and search-result links (url mode).
sortBy	string	"relevance"	relevance, price_asc, price_desc, unit_price_asc, unit_price_desc, or name.
minRating	string	"0"	Minimum average rating: 0, 3, 4, or 5.
onPromotionOnly	boolean	false	Keep only products with a genuine reduced price.
inStockOnly	boolean	false	Keep only products currently in stock.
minPrice	integer	none	Keep only products priced at or above this amount, in EUR.
maxPrice	integer	none	Keep only products priced at or below this amount, in EUR.
fetchDetails	boolean	true	Fetch each product's page for a human-readable category breadcrumb. Price, stock, promotion and rating are always fetched regardless of this toggle. The product page is also always fetched for a pasted product link or EAN, and whenever Minimum rating is set, even with this off.
maxItems	integer	20	Stop after this many products (0 = no limit).
maxPages	integer	0	Result pages walked per keyword, category or link (0 = unlimited).
resumeFromRunId	string	none	Continue one interrupted or previous run.
incrementalMode	boolean	false	Return only new and changed products on recurring runs of the same store and search.
stateKey	string	none	Name or share an incremental-mode state.
emitUnchanged	boolean	false	Also return (and bill) unchanged products.
emitExpired	boolean	false	Also return (and bill) products no longer found, once a run has fully scanned the search.
proxy	object	{"useApifyProxy": true}	Connection settings. A datacenter connection is used by default.
mcpConnectors	array	none	Optional: send a summary of each product to apps you authorized under Integrations.
notionParentPageUrl	string	none	Notion connector only: page under which item pages are created.
maxNotifyListings	integer	50	Cap on items written to each connector per run.

Output Example

Sample shape: values are illustrative placeholders, not from a live record.

{
  "productId": "3661112223334",
  "ean": "3661112223334",
  "title": "Lessive liquide 40 lavages",
  "brand": "Marque Repere",
  "description": "Lessive liquide concentree pour un lavage efficace au quotidien.",
  "descriptionHtml": "<p>Lessive liquide concentree pour un lavage efficace au quotidien.</p>",
  "images": ["https://media.e.leclerc/3661112223334_1"],
  "categoryPath": "Entretien > Lessives > Lessives liquides",
  "price": 8.49,
  "currency": "EUR",
  "unitPrice": 0.21,
  "unitPriceUnit": "lavage",
  "unitPriceDisplay": "0.21 EUR / lavage",
  "wasPrice": 9.99,
  "discountAmount": 1.5,
  "discountPercent": 15.0,
  "onPromotion": true,
  "availabilityStatus": "in-stock",
  "inStock": true,
  "stock": 214,
  "rating": 4.3,
  "reviewCount": 112,
  "reviews": [],
  "storeSignCode": "1375",
  "storeName": "Montparnasse",
  "storePostalCode": "75014",
  "canonicalUrl": "https://www.e.leclerc/fp/lessive-liquide-40-lavages-3661112223334",
  "searchMode": "search",
  "source": "listing",
  "scrapedAt": "2026-09-15T08:00:00Z"
}

Plan Requirement

The default proxy setting works out of the box: this actor connects through a datacenter exit by default, which is sufficient here, and residential is optional and never required. The Pricing tab shows the current per-event rates for this actor.

FAQ

How much does it cost?

You pay per product returned, plus a detail-enrichment charge only for a product that is actually returned in the dataset and whose page was fetched and read. The page is fetched when Fetch product details is on, for every pasted product link or EAN, and whenever Minimum rating is set. The Pricing tab shows the current rates. Use Max products to cap the cost of any run.

Is it legal to scrape E.Leclerc?

This actor collects only publicly available product data. You are responsible for how you use it: follow E.Leclerc's terms and the laws that apply to you, and get legal advice if you plan commercial redistribution. Product names, prices and stock are generally facts, but images and description text may be subject to third-party rights.

Why does the price and stock look the same for every store I try?

This is expected, not a bug. The price, promotion and stock this actor returns are the storefront's national reference offer, verified live to be identical across distant stores. Choosing a store still stamps every record with storeSignCode, storeName and storePostalCode, and keeps a separate incremental baseline per store unless you set the same stateKey for both, but it does not change the price or stock values.

Can I get only new or changed products on a schedule?

Yes. Schedule the actor from the Schedules tab and turn on Incremental changes for scheduled runs. Each run then returns only new and updated products, and unchanged ones are not billed. A product only comes back as REAPPEARED if an earlier run had Emit expired products on and had already marked it EXPIRED; turning emitExpired on for the first time will not retroactively produce REAPPEARED rows.

Why did my run fail instead of returning an empty dataset?

If the postal code or store sign code you provided cannot be resolved to a real E.Leclerc store, the run stops with a clear message instead of silently returning nothing. Check the code and try again. If the store resolves but no products match your keywords, links or filters, the run finishes normally with an empty dataset and a status message explaining why.

Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push results into Notion, Linear or Airtable.

🔗 Want more grocery data?

Pair this actor with these related scrapers from the same team:

🥦 Auchan France Scraper Scrape Auchan.fr products: grocery, drinks, household and general merchandise. Real price...	🥦 REWE.de Scraper Scrape REWE Germany (rewe.de) grocery products: current price, was-price and discount...
🍷 Carrefour Spain Scraper Scrape Carrefour Spain (carrefour.es) products. Search by keyword, browse a category, or...	🥦 Mercadona Scraper Scrape Mercadona products by delivery-area postal code. Search by keyword or category, or...
🥦 Instacart Scraper Scrape Instacart grocery catalogs with per-store prices. Run keywords across several...	🥦 FoodHero Scraper Scrape FoodHero surplus grocery deals across Canada by area, store or offer ID. Extract...

👉 Browse all abotapi scrapers

💬 Support & custom scrapers

• 🐞 Found a bug or a missing field? Open a ticket on the Issues tab. We usually reply within hours.
• 🛠️ Need another site, extra fields or a private build? Email contact@abotapi.com or message Telegram @abotapi.
• ⭐ Enjoying it? A quick review on the actor page helps other users find it.