Carrefour Scraper — French Grocery Prices

Scrape grocery products, prices, unit prices, EAN barcodes, ratings, and images from carrefour.fr, France's largest supermarket retailer. Search any keyword and export clean, structured grocery data.

Why use this actor?

Carrefour is one of the largest grocery catalogues in France, and its prices, promotions, and EAN barcodes are valuable for price monitoring, competitor analysis, product matching, and market research. This actor turns a keyword search into a structured dataset you can drop straight into a spreadsheet, database, or price-comparison pipeline. Every product comes with its 13-digit EAN barcode, which makes it easy to match Carrefour items against other retailers or your own catalogue.

How to scrape Carrefour data

1. Enter a search query in French (for example lait, cafe, pain, or chocolat).
2. Set Max Results to how many products you want (each search page returns 30 products; the actor paginates automatically).
3. Provide a Bright Data API key (see "Anti-bot" below).
4. Run the actor. Results stream into the dataset and can be exported as JSON, CSV, Excel, or via the API.

Optionally enable Fetch product details to visit each product page and add the category, full description, and a confirmed EAN from structured data. This is slower and more expensive because it makes one extra request per product, and it is not needed for price, EAN, unit price, brand, rating, or image — those come from the search page directly.

Input

Field	Type	Required	Description
searchQuery	String	No	Search keyword in French (default: lait)
maxResults	Integer	No	Maximum products to return (default: 100)
fetchDetails	Boolean	No	Visit each product page for category + description (default: false)
brightDataApiKey	String	Yes	Bright Data Web Unlocker API key (or set BRIGHT_DATA_API_KEY env var)
proxyConfiguration	Object	No	Kept for compatibility; fetching is handled by Bright Data

Output

Each result contains:

Field	Type	Example
productName	String	"Lait Demi-Ecrémé demi-écrémé SIMPL"
brand	String	"SIMPL"
price	Number	5.64
currency	String	"EUR"
unitPrice	String	"0.94 € / L"
originalPrice	Number	6.64 (only when on promotion)
discount	String	"-15%" (only when on promotion)
category	String	"Lait demi-écrémé" (only with Fetch product details)
productId	String	"3560071267964"
ean	String	"3560071267964"
rating	Number	4.88
reviewCount	Number	24
imageUrl	String	Primary product image URL
productDescription	String	Full description (only with Fetch product details)
url	String	Full product page URL
scrapedAt	String	ISO 8601 timestamp

Example output

{
    "productName": "Lait Demi-Ecrémé demi-écrémé SIMPL",
    "brand": "SIMPL",
    "price": 5.64,
    "currency": "EUR",
    "unitPrice": "0.94 € / L",
    "productId": "3560071267964",
    "ean": "3560071267964",
    "rating": 4.88,
    "reviewCount": 24,
    "imageUrl": "https://media.carrefour.fr/medias/9af83bb7b46d3d2ba6db1814c093cd3a/p_200x200/3560071267964-0.jpg",
    "url": "https://www.carrefour.fr/p/lait-demi-ecreme-demi-ecreme-simpl-3560071267964",
    "scrapedAt": "2026-07-12T21:29:22.000Z"
}

Anti-bot: Bright Data Web Unlocker required

Carrefour.fr is protected by DataDome. Plain HTTP requests and standard datacenter proxies receive a 403 challenge page instead of the real content. To fetch pages reliably, this actor uses the Bright Data Web Unlocker (zone web_unlocker1).

You need a Bright Data account with a Web Unlocker zone. Provide the API key either:

• in the input field Bright Data API Key, or
• as the environment variable BRIGHT_DATA_API_KEY.

Bright Data bills per request. Because each search page returns 30 products in a single request, the anti-bot cost per product is very low when you scrape the listing only (the default). Enabling Fetch product details adds one request per product and increases both time and cost significantly.

Cost estimate

• Listing only (default): roughly one Bright Data request per 30 products, plus Apify compute. Scraping 1,000 products is about 34 page requests — fast and cheap.
• With Fetch product details: one extra request per product (about 1,030 requests for 1,000 products), so runs are much longer and cost more. Only enable it when you need the category or full description.

How pagination works

Carrefour's search uses a simple ?q=<keyword>&page=<N> URL. The actor starts at page 1 and requests the next page until it reaches your Max Results or runs out of products. Each page yields 30 unique products, deduplicated by EAN so the same item is never exported twice.

For long runs with Fetch product details enabled, the actor persists its progress (seen products and page cursor). If Apify migrates the run to another host, it resumes where it left off instead of restarting, so you never get duplicate rows or a half-finished catalogue.

Limitations

• Prices and availability are national Carrefour catalogue values and may differ from a specific store or drive location.
• category and productDescription are only populated when Fetch product details is enabled.
• A Bright Data Web Unlocker key is required; without it the actor cannot fetch pages.
• Data is scraped from the public website and may change without notice.
• Respect the website's terms of service and use responsibly.

Related Scrapers

• Auchan Scraper — French grocery prices and products
• Leroy Merlin Scraper — French DIY and home improvement
• Continente Scraper — Portuguese grocery with EAN barcodes
• Dia Scraper — Spanish grocery prices

Need this data on a schedule, or a custom version?

We run this scraper as a managed service for businesses: scheduled runs, deduplication, delta detection, and delivery to your inbox, Google Sheets, or API — maintenance included. We can also build a custom version with your exact fields and filters, or combine multiple sources into one feed.

See studioamba.dev/services or email hello@studioamba.dev for a free data sample. We maintain 300+ European web scrapers and answer within one business day.