# Carrefour Scraper (`solidcode/carrefour-scraper`) Actor \[💰 $4.0 / 1K] Scrape Carrefour supermarket products: name, brand, price, unit price, promotions and discounts, stock availability, EAN, images, breadcrumbs, ratings and nutrition. Search by keyword or paste Carrefour category and product URLs across the Carrefour France catalog. - **URL**: https://apify.com/solidcode/carrefour-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 ```json { "searchQueries": ["café"] } ```` #### On-promotion coffee, cheapest first ```json { "searchQueries": ["café", "chocolat"], "sortBy": "price-asc", "promotionsOnly": true, "maxResults": 200 } ``` #### Paste a category aisle and a specific product ```json { "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: ```json { "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. # Actor input Schema ## `searchQueries` (type: `array`): Keywords to search on Carrefour France (carrefour.fr), such as 'café', 'coca cola' or 'shampoing'. Each keyword runs its own search. Leave empty if you are pasting URLs below. ## `startUrls` (type: `array`): Paste Carrefour France (carrefour.fr) links directly: search result pages, category (rayon) pages, or individual product pages. The type is detected automatically. Use this if you already have the exact pages you want. ## `sortBy` (type: `string`): Order in which products are collected for keyword and category searches. 'Relevance' is Carrefour's default ordering. ## `promotionsOnly` (type: `boolean`): When on, only products currently on promotion or discounted are returned. ## `maxResults` (type: `integer`): Maximum number of products to return in total, across all keywords and URLs. Set to 0 to collect everything available (capped at 50,000 to keep runs bounded). Tip: start with 20-100 to test, then increase. ## Actor input object example ```json { "searchQueries": [ "café" ], "startUrls": [], "sortBy": "relevance", "promotionsOnly": false, "maxResults": 100 } ``` # Actor output Schema ## `overview` (type: `string`): Table of scraped products with key fields. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "café" ], "startUrls": [], "sortBy": "relevance", "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/carrefour-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["café"], "startUrls": [], "sortBy": "relevance", "maxResults": 100, } # Run the Actor and wait for it to finish run = client.actor("solidcode/carrefour-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "café" ], "startUrls": [], "sortBy": "relevance", "maxResults": 100 }' | apify call solidcode/carrefour-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/carrefour-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Carrefour Scraper", "description": "[💰 $4.0 / 1K] Scrape Carrefour supermarket products: name, brand, price, unit price, promotions and discounts, stock availability, EAN, images, breadcrumbs, ratings and nutrition. Search by keyword or paste Carrefour category and product URLs across the Carrefour France catalog.", "version": "1.0", "x-build-id": "nS30csqB81qPcYcJs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~carrefour-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-carrefour-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/solidcode~carrefour-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-carrefour-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/solidcode~carrefour-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-carrefour-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQueries": { "title": "Search Keywords", "type": "array", "description": "Keywords to search on Carrefour France (carrefour.fr), such as 'café', 'coca cola' or 'shampoing'. Each keyword runs its own search. Leave empty if you are pasting URLs below.", "items": { "type": "string" } }, "startUrls": { "title": "Carrefour URLs", "type": "array", "description": "Paste Carrefour France (carrefour.fr) links directly: search result pages, category (rayon) pages, or individual product pages. The type is detected automatically. Use this if you already have the exact pages you want.", "items": { "type": "string" } }, "sortBy": { "title": "Sort Results By", "enum": [ "relevance", "price-asc", "price-desc", "top-rated", "promotions" ], "type": "string", "description": "Order in which products are collected for keyword and category searches. 'Relevance' is Carrefour's default ordering.", "default": "relevance" }, "promotionsOnly": { "title": "On-promotion products only", "type": "boolean", "description": "When on, only products currently on promotion or discounted are returned.", "default": false }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Maximum number of products to return in total, across all keywords and URLs. Set to 0 to collect everything available (capped at 50,000 to keep runs bounded). Tip: start with 20-100 to test, then increase.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```