Carrefour Product Scraper

What does Carrefour Product Scraper do?

Carrefour Scraper extracts structured product data from carrefour.fr, including current prices, GTINs, categories, unit prices, availability, ingredients, ratings, review counts, product URLs, images, and basket line totals. It supports keyword search, category/rayon filters, product URLs, price filters, unit-price filters, ingredient filtering, sorting, controllable result limits, detail enrichment, incremental tracking, and notifications.

New to Apify? Sign up free and use the included $5 monthly platform credit to test this actor.

Key features

• 🔍 Keyword search — search Carrefour France products with query; pass a JSON array to run several product searches in one dataset.
• 🛍️ Shopping-basket monitor — monitor a shopping basket by productIds or productUrls and optional quantities; output includes line totals for basket-level tracking.
• 💰 Current Carrefour prices — each row includes current EUR price, availability and purchase limits when Carrefour exposes them.
• ⚖️ Per-unit comparison pricing — returns unitPrice and unitPriceUnit for pack-size comparisons.
• 🛒 Category and rayon filters — scope discovery with category URLs, rayonIds or category text filters.
• 🥗 Ingredients + structured nutrition — detail mode can return ingredients, allergens, Nutri-Score, Eco-Score and nutrition tables when those fields are present in Carrefour product data; use ingredientFilter to keep only matching enriched rows.
• 🏷️ Product metadata — Rows include GTIN, Carrefour base code, brand, packaging, category path, images, ratings and review counts when available.
• 🔢 EAN / UPC barcodes — gtin supports stable matching across price monitors and catalog joins.
• 📦 Compact product output — keep only core product, price, availability, basket and image fields.
• 🔔 Notifications — Send product alerts to Telegram, Discord, Slack, WhatsApp or a generic webhook, with optional change-only notifications.
• ♻️ Incremental mode — track a product search over time and emit changeType rows.

What data can you extract from carrefour.fr?

Each result includes Core product fields (url, name, brand, price, currency, unitPrice, unitPriceUnit, and in_stock, and more) and detail fields when enrichment is enabled (description). In standard mode, all fields are always present — unavailable data points are returned as null, never omitted. In compact mode, only core fields are returned.

Enable detail enrichment in the input to get richer fields such as full descriptions where the source provides them.

Input

The main inputs are a search keyword and a result limit. Additional filters and options are available in the input schema.

Key parameters:

• productIds — Track a specific shopping list by GTIN/barcode or Carrefour product ID. Product URLs are also accepted here. Pair with quantities to compute per-line basket totals. (default: [])
• productUrls — Carrefour product URLs to scrape directly, equivalent to the 123webdata productUrls input. (default: [])
• categoryUrls — Carrefour category/search URLs. URLs with q/query/search become keyword searches; URLs with rayonId/filter=rayonId use Carrefour category filtering. (default: [])
• startUrls — Paste Carrefour product, search or category URLs. Product URLs are scraped directly; search/category URLs build the matching query and supported Carrefour filters, including multi-select, range, delivery, category-path and boolean facets like filters[facet_promotions][0]=..., filters[facet_price][gte]=... and filters[product.categories...]=... (default: [])
• query — Product search keywords. Use a single term like "lait" or paste a JSON array such as ["lait","pâtes"]. Ignored when productIds/productUrls are supplied. (default: "")
• categories — Local category filter after fetch. Use terms such as "Surgelés", "Lait", or "Crèmerie". (default: [])
• rayonIds — Advanced Carrefour category IDs used as API filters, e.g. 29298 for a specific milk subcategory. (default: [])
• quantities — Optional per-product quantities. Accepts an object map like {"3176571983008": 2} or array pairs like [{"gtin":"3176571983008","qty":2}]. (default: {})
• maxResults — Maximum number of product rows to push. Use 0 only when you intentionally want all products for the selected query/category. (default: 50)
• maxResultsPerScrape — Compatibility alias for 123webdata/carrefour-scraper. If maxResults is not set, this value is used.
• usePagination — Whether to fetch additional pages after the first page for query/category runs. (default: true)
• pageSize — Products requested per page. (default: 24)
• ...and 30 more parameters

Input examples

Basic search — Keyword-driven search with a result cap.

→ Full payload per result — all standard fields populated where the source provides them.

{
  "query": "lait",
  "maxResults": 50
}

Incremental tracking — Only emit products that changed since the previous run with this stateKey.

→ First run builds the baseline state. Subsequent runs emit only records that are new or whose tracked content changed. Set emitUnchanged: true to include unchanged records as well.

{
  "query": "lait",
  "maxResults": 200,
  "incrementalMode": true,
  "stateKey": "lait-tracker"
}

Compact output for AI agents — Return only core fields for AI-agent and MCP workflows.

→ Small payload with the most important fields — ideal for piping into LLMs without token overhead.

{
  "query": "lait",
  "maxResults": 50,
  "compact": true
}

Output

Each run produces a dataset of structured product records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console.

Example product record

{
  "url": "https://www.carrefour.fr/p/lait-vitamine-viva-candia-3176571983008",
  "name": "Lait Vitaminé Viva CANDIA",
  "brand": "CANDIA",
  "price": 1.15,
  "currency": "EUR",
  "unitPrice": 1.15,
  "unitPriceUnit": "L",
  "in_stock": true,
  "gtin": "3176571983008",
  "sku": "3176571983008",
  "categoryName": "Lait demi-écrémé",
  "description": "Comme le lait demi-écrémé, Viva vous accompagne dès le petit déjeuner ! Source de 12 vitamines, Viva est le lait de la vitalité* pour toute la famille. Il contient les vitamines B1, B2, PP, B5, B6, B8...",
  "ingredients": "LAIT à 1,0% de matières grasses, lactase, vitamines : A, B1, B2, B5, B6, B8, B9, B12, E, PP, D et K",
  "nutriscore": "A",
  "quantity": 2,
  "linePrice": 2.3,
  "rating_value": 4.64,
  "review_count": 1257,
  "main_image": "https://media.carrefour.fr/media/referential/media/462baa4eba6a43cdb155645ffba966d1/p_1500x1500/03176571983008_H1L1_s13.jpeg",
  "scraped_at": "2026-07-01T17:32:07.206Z",
  "source": "carrefour.fr"
}

Incremental fields

When incremental mode is on, each record also carries:

• changeType — one of NEW, UPDATED, UNCHANGED, REAPPEARED, EXPIRED. Default output covers NEW / UPDATED / REAPPEARED; set emitUnchanged: true or emitExpired: true to opt into the others.
• isRepost, repostOfId, repostDetectedAt — populated when a new listing matches the tracked content of a previously expired one. Set skipReposts: true to drop detected reposts from the output.

How to scrape carrefour.fr

1. Go to Carrefour Product Scraper in Apify Console.
2. Enter a search keyword.
3. Set maxResults to control how many results you need.
4. Enable includeDetails if you need full descriptions.
5. Click Start and wait for the run to finish.
6. Export the dataset as JSON, CSV, or Excel.

Use cases

• Extract product data from carrefour.fr for market research and competitive analysis.
• Track pricing trends across regions and categories over time.
• Monitor new and changed products on scheduled runs without processing the full dataset every time.
• Feed structured data into AI agents, MCP tools, and automated pipelines using compact mode.
• Export clean, structured data to dashboards, spreadsheets, or data warehouses.
• Benchmark seller / dealer reputation using rating fields.

How much does it cost to scrape carrefour.fr?

Carrefour Product Scraper uses pay-per-event pricing. You pay a small fee when the run starts and then for each result that is actually produced.

• Run start: $0.01 per run
• Per result: $0.002 per product record

Example costs:

• 10 results: $0.03
• 25 results: $0.06
• 100 results: $0.21
• 200 results: $0.41
• 500 results: $1.01

Example: recurring monitoring savings

These examples compare full re-scrapes with incremental runs at different churn rates. Churn is the share of products that are new or whose tracked content changed since the previous run. Actual churn depends on your query breadth, source activity, and polling frequency — the scenarios below are examples, not predictions.

Example setup: 200 results per run, daily polling (30 runs/month). Event-pricing examples scale linearly with result count.

Churn rate	Full re-scrape run cost	Incremental run cost	Savings vs full re-scrape	Monthly cost after baseline
5% — stable niche query	$0.41	$0.03	$0.38 (93%)	$0.90
15% — moderate broad query	$0.41	$0.07	$0.34 (83%)	$2.10
30% — high-volume aggregator	$0.41	$0.13	$0.28 (68%)	$3.90

Full re-scrape monthly cost at daily polling: $12.30. First month with incremental costs $1.28 / $2.44 / $4.18 for the 5% / 15% / 30% scenarios because the first run builds baseline state at full cost before incremental savings apply.

Platform usage (compute and proxies) is billed separately by Apify based on actual consumption. Incremental runs consume less on result processing, though fixed per-run overhead stays the same.

FAQ

How many results can I get from carrefour.fr?

The number of results depends on the search query and available products on carrefour.fr. Use the maxResults parameter to control how many results are returned per run.

Does Carrefour Product Scraper support recurring monitoring?

Yes. Enable incremental mode to only receive new or changed products on subsequent runs. This is ideal for scheduled monitoring where you want to track changes over time without re-processing the full dataset.

Can I integrate Carrefour Product Scraper with other apps?

Yes. Carrefour Product Scraper works with Apify's integrations to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes.

Can I use Carrefour Product Scraper with the Apify API?

Yes. You can start runs, manage inputs, and retrieve results programmatically through the Apify API. Client libraries are available for JavaScript, Python, and other languages.

Can I use Carrefour Product Scraper through an MCP Server?

Yes. Apify provides an MCP Server that lets AI assistants and agents call this actor directly. Use compact mode, descriptionMaxLength, a single descriptionFormat, and excludeEmptyFields to keep payloads manageable for LLM context windows.

Is it legal to scrape carrefour.fr?

This actor extracts publicly available data from carrefour.fr. Web scraping of public information is generally considered legal, but you should always review the target site's terms of service and ensure your use case complies with applicable laws and regulations, including GDPR where relevant.

Your feedback

If you have questions, need a feature, or found a bug, please open an issue on the actor's page in Apify Console. Your feedback helps us improve.

You might also like

• Bilka Scraper - Danish Grocery Products & Prices — Scrape Bilka (Salling Group), Denmark's largest hypermarket chain. Get the full product catalog.
• Coop365 Scraper - Danish Grocery Products & Prices — Scrape current Coop365 leaflet rows from 365discount.coop.dk with structured names, prices, unit.
• Føtex Scraper - Danish Grocery Products & Prices — Scrape Føtex (Salling Group), one of Denmark's largest supermarket chains. Get the full product.
• Kvickly Scraper - Danish Grocery Products & Prices — Scrape current Kvickly leaflet rows from www.kvickly.dk with structured names, prices, unit.
• Lidl Scraper - European Grocery Products & Prices — Scrape Lidl grocery products and prices across 28 European markets, each row tagged by country. Get.
• Nemlig Scraper - Danish Online Grocery Products & Prices — Scrape Nemlig grocery products from nemlig.com as structured JSON with shelf prices, current.
• Netto Scraper - Danish Grocery Products & Prices — Scrape Netto (Salling Group), Denmark's largest discount-grocery chain. Get the full product.
• REMA 1000 Scraper - Danish Grocery Products & Prices — Scrape rema1000.dk — Denmark's largest discount-grocery chain with 3900 SKUs. Search products by.

Getting started with Apify

New to Apify? Create a free account with $5 credit — no credit card required.

1. Sign up — $5 platform credit included
2. Open this actor and configure your input
3. Click Start — export results as JSON, CSV, or Excel

Need more later? See Apify pricing.