Mercadona Product Scraper — Spanish Supermarket Catalog

Scrape the full Mercadona product catalog, priced for any Spanish postal code. Name, price, price per kg or litre, previous price, packaging, full category path and image for every product, plus EAN barcode, brand, ingredients and allergens when you switch on product details.

---

Why use this scraper

• Local prices. Enter a postal code and get the prices of the warehouse that delivers there. Fresh food prices differ between Madrid, Barcelona, Valencia and Sevilla.
• Full catalog. All 26 top categories and 152 subcategories, each product returned once even when Mercadona lists it in two places.
• Comparable prices. Price per kg or litre, the previous price when a product got cheaper, and the VAT rate, all as numbers.
• Product details on demand. EAN barcode, brand, origin, suppliers, ingredients, allergens and full-size photos.
• No login. Reads Mercadona's public online shop.

---

Overview

Mercadona is Spain's largest supermarket chain. Its online shop (tienda.mercadona.es) serves each delivery area from a regional warehouse, and the warehouse sets the prices and the product range. This actor turns a postal code into that warehouse, walks every category, and writes one clean row per product.

---

Use cases

• Price monitoring. Track Mercadona prices and price drops over time, per region.
• Regional price comparison. Run the same catalog for several postal codes and compare fresh food prices.
• Product matching. Use the EAN barcode to match Mercadona products against Carrefour, Dia, Lidl or Alcampo.
• Nutrition and allergen apps. Ingredients and allergen statements for every product.
• Market research. Mercadona's private labels (Hacendado, Deliplus, Bosque Verde) against branded products, category by category.

---

How it works

1. If you gave a postal code, the actor asks Mercadona which warehouse delivers there.
2. It fetches the category tree, then every subcategory in parallel, using that warehouse's prices.
3. Products already seen in another subcategory are skipped.
4. With Include product details on, it fetches each product's detail page as well.
5. Each product is written to the dataset as one flat row.

---

Input

Field	Type	Default	Notes
postalCode	string	empty	Five-digit Spanish postal code, e.g. 28001. Empty uses Mercadona's default warehouse (Valencia).
includeDetails	boolean	false	Adds EAN, brand, origin, suppliers, ingredients, allergens, instructions and photos. One extra request per product.
maxItems	integer	1000	Maximum products to return.
maxConcurrency	integer	8	How many requests run in parallel.
proxy	object	Apify proxy	Proxy configuration.

{
  "postalCode": "08001",
  "includeDetails": true,
  "maxItems": 5000
}

---

Output

One row per product. Example from a Barcelona run (08001) with product details on:

{
  "type": "product",
  "productId": "4240",
  "slug": "aceite-oliva-04o-hacendado-botella",
  "displayName": "Aceite de oliva 0,4º Hacendado",
  "packaging": "Botella",
  "unitPrice": 3.7,
  "bulkPrice": 3.7,
  "referencePrice": 3.7,
  "referenceFormat": "L",
  "previousUnitPrice": null,
  "priceDecreased": false,
  "currency": "EUR",
  "unitSize": 1,
  "sizeFormat": "l",
  "taxPercentage": 4,
  "isNewArrival": false,
  "purchaseLimit": 999,
  "requiresAgeCheck": false,
  "thumbnail": "https://prod-mercadona.imgix.net/images/65c2349950feb1958362e06217003b10.jpg?fit=crop&h=300&w=300",
  "shareUrl": "https://tienda.mercadona.es/product/4240/aceite-oliva-04o-hacendado-botella",
  "category": "Aceite, especias y salsas",
  "categoryId": 12,
  "subcategory": "Aceite, vinagre y sal",
  "subcategoryId": 112,
  "section": "Aceite de oliva",
  "sectionId": 420,
  "categoryPath": "Aceite, especias y salsas > Aceite, vinagre y sal > Aceite de oliva",
  "postalCode": "08001",
  "warehouse": "bcn1",
  "published": true,
  "scrapedAt": "2026-10-26T11:39:08.116Z",
  "detailsFetched": true,
  "ean": "8402001027475",
  "brand": "Hacendado",
  "origin": "España",
  "suppliers": ["Aceites Abril S.L.", "SOVENA ESPAÑA S.A.U."],
  "legalName": "HACENDADO ACEITE DE OLIVA",
  "ingredients": "Ingredientes: Aceite de oliva refinado y Aceite de Oliva Virgen.",
  "allergens": null,
  "usageInstructions": "Cocinar y sazonar",
  "isBulk": false,
  "isVariableWeight": false,
  "images": [
    "https://prod-mercadona.imgix.net/images/65c2349950feb1958362e06217003b10.jpg?fit=crop&h=3600&w=3600"
  ]
}

Key output fields

• productId: Mercadona product ID, stable across runs.
• unitPrice: the shelf price of one item, in EUR.
• referencePrice / referenceFormat: price per kg or litre (referenceFormat is e.g. kg or L), for comparing pack sizes.
• previousUnitPrice / priceDecreased: the earlier price when Mercadona has lowered it.
• taxPercentage: VAT rate (4, 10 or 21).
• categoryPath: top category, subcategory and section, joined with >.
• postalCode / warehouse: the postal code you asked for and the Mercadona warehouse that priced the row.
• ean: EAN-13 barcode (product details only).
• ingredients / allergens: plain text; allergens is null when Mercadona declares none (product details only).
• images: full-size photos, 3600 px (product details only).

---

FAQ

Do I need a Mercadona account? No. The actor reads the public online shop.

Why does the postal code matter? Mercadona prices online orders by regional warehouse. In a test of the fruit aisle, about half the products had a different price in Madrid, Barcelona or Sevilla than in Valencia, and each warehouse stocks a slightly different range.

What happens if Mercadona does not deliver to my postal code? The run stops at once with a message saying so. Try a nearby postal code.

How many products are in the catalog? Around 4,000 to 4,500, depending on the warehouse. Set maxItems to 5000 to get all of them.

Are prices in EUR? Yes, all prices are in euros, VAT included.

---

⚠️ Disclaimer

This Actor scrapes publicly available product data from tienda.mercadona.es. It does not access authenticated or private content. You are responsible for using the output in line with Mercadona's terms and any applicable law in your jurisdiction. This Actor is not affiliated with, endorsed by, or sponsored by Mercadona.

---

SEO Keywords

mercadona scraper, mercadona product scraper, spanish supermarket scraper, mercadona api, mercadona catalog, mercadona prices, mercadona prices by postal code, mercadona ean, mercadona ingredients allergens, tienda mercadona, supermarket price scraper, spain grocery scraper, mercadona product data, mercadona csv export, grocery price monitoring