Carrefour France Scraper

Pull the full Carrefour France (carrefour.fr) grocery catalog at scale — prices, unit prices (€/kg, €/L), multi-buy promotion deals, EAN barcodes, Eco-Score, ingredient composition, nutrition attributes, brand, availability, and high-resolution images for every product. Search by plain keyword like "café" or paste any category aisle or product URL. Built for grocery price analysts, CPG and private-label brand teams, market researchers, and meal-planning or price-comparison apps who need structured Carrefour catalog data without copying it product by product.

Why This Scraper?

• EAN barcode and SKU on every product — each row carries the 13-digit EAN/GTIN and Carrefour's internal product id, so you can match against your own catalog, a supplier feed, or a competing retailer instantly.
• True unit pricing (€/kg, €/L) — every product returns the price-per-unit label (e.g. "23.60 € / KG") alongside the pack price, so you compare a 250 g jar against a 1 kg bag on the same basis.
• Multi-buy promotion labels captured verbatim — "lot de 2", "3 achetés le 4e offert" and other Carrefour deal text is pulled into promotionLabel, with an onPromotion flag and an on-promotion-only filter for pure deal monitoring.
• Eco-Score, Nutri-Score, and full ingredient composition — regulated product name, ingredient list, Eco-Score and Nutri-Score grades, storage instructions, and consumer benefits are enriched from each product page.
• Keyword search OR paste URLs — type a term and let the scraper build the search, or paste a Carrefour search, category (rayon), or product link; the URL type is detected automatically.
• Five sort modes — Relevance, Price Low→High, Price High→Low, Top Rated, and On Promotion, applied across keyword and category searches.
• High-resolution 1500×1500 images — the primary image plus the full gallery, upgraded to full 1500×1500 resolution rather than tiny thumbnails.
• Aggregate ratings and review counts — average customer rating and total review count on every product row for quality and popularity signals.
• Full detail enrichment on every row — breadcrumb category path, brand, pack size/weight, in-stock status, and product description are filled in for each product, not just the ones on the first page.

Use Cases

Grocery Price Intelligence

• Track everyday and promotional prices across the Carrefour France catalog
• Compare unit prices (€/kg, €/L) across pack sizes to find true value
• Monitor price changes on a watchlist of products over time
• Benchmark Carrefour pricing against other retailers by matching on EAN

CPG & Private-Label Brand Monitoring

• Verify that your products are listed, in stock, and correctly priced
• Audit Eco-Score, Nutri-Score, and ingredient composition displayed on shelf
• Track how Carrefour private labels are positioned against your brands
• Confirm on-shelf images and product descriptions match your specs

Promotion & Deal Tracking

• Pull only on-promotion products with the on-promotion-only filter
• Capture multi-buy deal wording for competitive promo analysis
• Sort by On Promotion to surface every active discount in a category
• Feed live deals into price-alert and cashback apps

Market Research

• Map an entire aisle by pasting a category (rayon) URL
• Analyze assortment breadth and brand share within a category
• Study Nutri-Score and Eco-Score distribution across a product segment
• Build category dashboards from clean, structured product rows

Meal-Planning & Comparison Apps

• Power grocery-comparison and shopping-list apps with live catalog data
• Surface ingredients, allergen-relevant composition, and nutrition per product
• Enrich recipe apps with real prices, pack sizes, and product images
• Keep a product database fresh with EAN-keyed updates

Getting Started

Simple keyword search

{
  "searchQueries": ["café"]
}

On-promotion coffee, cheapest first

{
  "searchQueries": ["café", "chocolat"],
  "sortBy": "price-asc",
  "promotionsOnly": true,
  "maxResults": 200
}

Paste a category aisle and a specific product

{
  "startUrls": [
    "https://www.carrefour.fr/r/epicerie-sucree/cafes",
    "https://www.carrefour.fr/p/cafe-moulu-classique-100-arabica-intensite-7-carte-noire-8000070200326"
  ],
  "maxResults": 500
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
searchQueries	array of strings	["café"]	Keywords to search on Carrefour France, such as "café", "coca cola", or "shampoing". Each keyword runs its own search.
startUrls	array of strings	[]	Carrefour France links: search result pages, category (rayon) pages, or individual product pages. The type is detected automatically.

Provide keywords, URLs, or both — at least one is needed to get results.

Filters & Ordering

Parameter	Type	Default	Description
sortBy	string	"relevance"	Order products for keyword and category searches: relevance, price-asc (Price: Low to High), price-desc (Price: High to Low), top-rated, or promotions (On Promotion).
promotionsOnly	boolean	false	When on, only products currently on promotion or discounted are returned.

Limits

Parameter	Type	Default	Description
maxResults	integer	100	Maximum products to return in total, across all keywords and URLs. Set to 0 to collect everything available. Start with 20–100 to test, then increase.

Output

Each product is returned as one flat record. Example:

{
  "url": "https://www.carrefour.fr/p/cafe-moulu-classique-100-arabica-intensite-7-carte-noire-8000070200326",
  "name": "Café moulu classique 100% arabica intensité 7 Carte Noire",
  "brand": "Carte Noire",
  "price": 5.90,
  "regularPrice": null,
  "unitPrice": "23.60 € / KG",
  "currency": "EUR",
  "onPromotion": true,
  "promotionLabel": "Lot de 2 : le 2e à -50%",
  "discountPercentage": null,
  "inStock": true,
  "ean": "8000070200326",
  "sku": "P-12345678",
  "quantity": "250 g",
  "breadcrumbs": ["Epicerie sucrée", "Cafés", "Café moulu"],
  "category": "Café moulu",
  "mainImage": "https://media.carrefour.fr/medias/.../p_1500x1500.jpg",
  "images": ["https://media.carrefour.fr/medias/.../p_1500x1500.jpg"],
  "description": "Café moulu 100% arabica, intensité 7...",
  "attributes": {
    "ingredients": "Café 100% arabica",
    "regulatedName": "Café torréfié moulu",
    "ecoscore": "B",
    "nutriscore": "A",
    "storage": "À conserver au sec",
    "consumerBenefits": "Riche en arômes"
  },
  "averageRating": 4.5,
  "reviewCount": 128,
  "country": "fr",
  "scrapedAt": "2026-07-03T10:15:00+00:00"
}

Core Fields

Field	Type	Description
url	string	Canonical Carrefour product URL
name	string	Product name
brand	string	Brand, including Carrefour private labels
quantity	string	Pack size, weight, or volume (e.g. "250 g")
inStock	boolean	Whether the product is available to buy
category	string	Leaf category name
breadcrumbs	array	Full category path from aisle to product
country	string	Store country code (fr)
scrapedAt	string	ISO 8601 timestamp of collection

Pricing & Promotions

Field	Type	Description
price	number	Current selling price
regularPrice	number	Pre-discount price when a crossed-out price is shown (else null)
unitPrice	string	Price per unit, e.g. "23.60 € / KG"
currency	string	ISO currency code (EUR)
onPromotion	boolean	Whether the product is currently on promotion
promotionLabel	string	Multi-buy or discount deal text, verbatim
discountPercentage	number	Discount vs regular price when a crossed-out price exists (else null)

Identity, Media & Ratings

Field	Type	Description
ean	string	13-digit EAN/GTIN barcode
sku	string	Carrefour internal product id
mainImage	string	Primary product image at 1500×1500
images	array	All product image URLs at 1500×1500
description	string	Product description text
averageRating	number	Aggregate customer rating
reviewCount	integer	Total number of customer reviews

Nutrition & Eco (in attributes)

Key	Description
ingredients	Full ingredient list
regulatedName	Legal/regulated product name
ecoscore	Eco-Score grade (A–E)
nutriscore	Nutri-Score grade (A–E)
storage	Storage and conservation instructions
consumerBenefits / productBenefits	Marketing and consumer benefit text
origin / ingredientsOrigins	Product and ingredient origin, where available

Nutrition and Eco keys appear when Carrefour publishes them for the product; they are grouped under attributes so the core row stays clean.

Tips for Best Results

• Paste a category (rayon) URL to sweep a whole aisle — a link like /r/epicerie-sucree/cafes collects every product in that category with automatic pagination, no keyword needed.
• Use unitPrice to compare across pack sizes — a small jar can beat a large bag on €/kg; the unit price is the honest cross-pack comparison, not the sticker price.
• Set promotionsOnly to true for deal monitoring — combine it with sortBy: "promotions" to build a clean feed of every active discount in a search or category.
• Match on ean when merging with other sources — the EAN barcode is the stable key for joining Carrefour rows to your own catalog or a competitor's feed; product URLs and names change, barcodes don't.
• Start with a small maxResults to preview — run 20–100 first to confirm the query returns what you expect, then raise the cap or set 0 for everything available.
• Order matters for large pulls — pick top-rated to prioritize popular products or price-asc to lead with the cheapest; sorting is applied before the result cap, so the first rows are the ones you asked for.
• Promotion filters use Carrefour's own facet — a few filtered products are loyalty or basket discounts without deal text, so onPromotion can read false on a promo-filtered list; rely on promotionLabel for the exact deal wording.

Pricing

From $4.00 per 1,000 results — undercuts comparable Carrefour catalog extractors while returning richer per-product data (EAN, unit price, Eco-Score, nutrition). Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$0.48	$0.45	$0.43	$0.40
1,000	$4.80	$4.50	$4.30	$4.00
10,000	$48.00	$45.00	$43.00	$40.00
100,000	$480.00	$450.00	$430.00	$400.00

A "result" is one product row returned to your dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This scraper collects publicly available product information from Carrefour France for legitimate business purposes such as price monitoring, market research, and competitive analysis. Use it responsibly: respect Carrefour's terms of service, do not overload their systems, and comply with all applicable laws and regulations in your jurisdiction. The data returned is factual product information and contains no personal data. You are responsible for how you use the collected data.