Carrefour Spain Product Scraper

Scrape products from Carrefour Spain (carrefour.es) — the supermarket and general‑retail catalog. Search by keyword, browse a category, fetch specific products, or paste links. Every product comes back as one flat record with price, unit price, promotion, stock and category; enable details to add the barcode (EAN), ingredients, allergens, the full nutrition panel, extra images and the product's aggregate rating.

What you can do

• Search by keyword — e.g. leche (milk), cerveza (beer), pañales (diapers) — with price, promotion, stock and rating filters, plus sorting.
• Browse a category — paste a Carrefour category page link and walk it across all its pages.
• Paste links or ids — mix product links, bare product ids and category links in one list and let the actor route each entry. Product links return full detail.

Input

Field	Description
Mode	search, category or url.
Search keywords	Keywords to search (search mode). Each is searched separately.
Category links	Carrefour category page links to browse (category mode).
Carrefour Spain links or product ids	Product links, bare product ids and category links to scrape directly, mixed freely (url mode). Product links return full detail.
Sort by	Relevance, price ↑/↓, unit price ↑/↓, or name. Applied over the collected products.
Minimum average rating	Keep only products rated at least N stars (needs details).
Only on promotion	Keep only products with a reduced price.
Only in stock	Keep only products currently in stock.
Min / Max price (EUR)	Keep only products within a price range.
Fetch product details	Add barcode, ingredients, allergens, nutrition, extra images and rating. On by default.
Max products	The run's cap on how many products to return. Default 20; 0 = unlimited.
Max pages per keyword / category	Optional safety bound on result pages. Leave empty for no page limit — the run stops at Max products.
Proxy	Apify Proxy — a Spanish residential exit by default (required, see below).
mcpConnectors	Optional MCP connectors to export results into (Notion, Linear, Airtable, Apify).
notionParentPageUrl	Notion connector only: page under which item pages are created.
maxNotifyListings	Cap on items exported to each connector per run. Does not affect the dataset.

Output

One record per product. With details off you get the listing‑level fields; with details on you also get barcode, ingredients, allergens, nutrition and rating. Example (illustrative values):

{
  "productId": "520661336",
  "name": "Leche semidesnatada marca ejemplo brik 1 L",
  "brand": "Marca Ejemplo",
  "ean": "8400000000000",
  "price": 0.99,
  "regularPrice": 1.19,
  "unitPrice": 0.99,
  "unitPriceMeasure": "l",
  "currency": "EUR",
  "onPromotion": true,
  "discountPercentage": 17,
  "inStock": true,
  "stock": 240,
  "categoryId": "cat00000",
  "ingredients": "Leche de vaca semidesnatada.",
  "allergens": ["Leche"],
  "nutrition": [{ "name": "Valor energético", "value": "46 kcal" }],
  "rating": 4.5,
  "reviewCount": 12,
  "reviews": [],
  "image": "https://static.carrefour.es/example/000000.jpg",
  "images": ["https://static.carrefour.es/example/000000.jpg"],
  "url": "https://www.carrefour.es/supermercado/example/R-520661336/p",
  "searchMode": "search",
  "scrapedAt": "2026-01-01T00:00:00Z"
}

Ratings & reviews. Products carry an aggregate rating (rating, reviewCount) where the catalog exposes one. Individual customer review text is not published in the catalog, so the reviews array is present but empty on rated products, and rating fields are simply absent on products with no rating (never fabricated zeros).

Proxy & connection

Apify Proxy is required. Carrefour Spain serves its catalog only to Spanish residential connections, so the actor uses a Spanish residential exit by default. On the Free plan (no residential proxy access) results may be empty — enable Apify Proxy or upgrade your plan at https://apify.com/pricing.

Send results into your apps (MCP connectors)

Optionally pipe results into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it in the mcpConnectors field. Each connector receives a condensed, human-readable summary per product (title plus key fields), while the complete record always stays in the Apify dataset. For Notion, set notionParentPageUrl to the page the item pages should be created under. Supported connectors: Notion, Linear, Airtable, and Apify. Leave the field empty to skip; it never changes the dataset output.

Notes

• Search and category result pages are walked forward one page at a time until Max products (or Max pages) is reached.
• searchMode on each record reports how it was found: search, category, or product when it came from a pasted product link or id.
• Prices are in EUR. Spanish price strings are normalized to numbers.
• Duplicate products (same id) are returned once per run.