Mercadona API — Real-Time Product & Price Data

What Is the FlyByAPIs Mercadona API?

FlyByAPIs Mercadona API is a REST service that returns product and price data from Spain’s largest supermarket as clean, structured JSON. Search the catalog, look up any product by barcode (EAN), walk the category tree, and pull price drops, new arrivals and best sellers, all scoped to the exact warehouse that serves any Spanish postal code. Available on RapidAPI starting at $0/month with 100 free requests.

Mercadona Product & Price Data for Any Postal Code

Mercadona has no public API. We built one: FlyByAPIs Mercadona API offers 14 endpoints covering the full online catalog, with real prices for the shopper’s real store, barcode lookup on every product, and discovery feeds like price drops and best sellers. One GET request, clean JSON back.

Here’s the part most people miss: Mercadona’s prices and assortment depend on the warehouse that serves each address. Scrape without resolving that and you get Valencia prices labelled as Madrid. Pass a postal code to any endpoint and we resolve it to the right warehouse for you, the same way mercadona.es does it, and every response says which warehouse answered.

Endpoints

Full reference with response schemas and examples in the Mercadona API docs .

Code Examples (Python, JavaScript, cURL)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

import requests

url = "https://mercadona-api.p.rapidapi.com/search"

querystring = {
    "q": "leche",
    "postal_code": "28001",
    "per_page": "5"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "mercadona-api.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)
data = response.json()["data"]

print(f"Warehouse: {data['resolved_filters']['warehouse']['resolved']}")
for p in data["results"]:
    print(f"{p['name']} | {p['price']} € ({p['unit_price']} €/{p['unit_price_format']}) | EAN {p['ean']}")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

const url = "https://mercadona-api.p.rapidapi.com/search?q=leche&postal_code=28001&per_page=5";

const options = {
  method: "GET",
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "mercadona-api.p.rapidapi.com",
  },
};

const response = await fetch(url, options);
const { data } = await response.json();

console.log(`Warehouse: ${data.resolved_filters.warehouse.resolved}`);
data.results.forEach((p) => {
  console.log(`${p.name} | ${p.price} € | EAN ${p.ean}`);
});

1
2
3
4
5
6

curl -G "https://mercadona-api.p.rapidapi.com/search" \
  --data-urlencode "q=leche" \
  --data-urlencode "postal_code=28001" \
  --data-urlencode "per_page=5" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: mercadona-api.p.rapidapi.com"

Example JSON Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

{
  "status": true,
  "request_id": "4a44b45a-d9bd-9470-b17d-49ceef2a",
  "data": {
    "results": [
      {
        "product_id": "10381",
        "name": "Leche semidesnatada Hacendado",
        "price": "4.98",
        "price_value": 4.98,
        "previous_price": "5.04",
        "is_price_drop": true,
        "unit_price": "0.830",
        "unit_price_format": "L",
        "ean": "8402001002090",
        "brand": "Hacendado",
        "warehouse": "mad3",
        "availability": { "in_stock": true },
        "thumbnail": "https://prod-mercadona.imgix.net/images/...jpg"
      }
    ],
    "total": 309,
    "page": 1,
    "total_pages": 50,
    "resolved_filters": {
      "warehouse": { "input": "28001", "resolved": "mad3", "source": "postal_code" }
    }
  }
}

Features

• Postal-code resolution — Pass any Spanish 5-digit postal code and get the catalog of the warehouse that actually delivers there, across 7 online hubs and 267 stores. Every response echoes the warehouse that answered.
• Barcode (EAN) on every result — Search results carry the product’s barcode, and /product-details accepts an EAN directly. No second call, no extra charge.
• Full product sheets — Ingredients, allergens, origin, supplier, storage instructions, alcohol %, VAT and photos in one request.
• Numbers you can sort — Prices come as real floats (price_value, unit_price_value) next to the display strings. No parsing “4,98 €” ever again.
• Price drops, computed honestly — We calculate discounts from the previous price we observed, not from Mercadona’s own flags, and return the saving in euros and percent.
• Discovery feeds — New arrivals, home-page campaigns and best sellers ranked by Mercadona’s internal popularity score.
• Three languages — Product and category names in Spanish, English or Catalan with one parameter.
• Structured JSON, always — Every endpoint returns the same clean envelope, with the filters it actually applied echoed back.

Use Cases

Why Developers Switch

Everyone who needs Mercadona data starts the same way: they find the undocumented endpoints behind tienda.mercadona.es and think the job is done. Then the gaps show up: no barcode lookup, no price-drop feed. And every answer is scoped to a warehouse you have to figure out yourself, so your “Madrid prices” are quietly Valencia prices until someone notices.

The alternatives have the same shape: a GitHub catalog dump that’s a static snapshot of one warehouse, or a no-code scraping tool that fights a JavaScript store page by rendering it. We took the other route: we did the warehouse-resolution, barcode-indexing and monitoring work once, and sell the result per request.

To be fair: if all you need is a one-time snapshot of the catalog for an analysis, a free GitHub dump will do, and we’d tell you to use one. The moment you need live prices, barcodes, or more than one region, the free options stop being free. You pay in engineering time instead.

Get Started in Minutes

1. Sign up on RapidAPI — it’s free.
2. Subscribe to the Basic plan (no credit card required).
3. Copy your API key from the RapidAPI dashboard.
4. Make your first request using the code examples above.

Every week spent maintaining a homemade Mercadona scraper is a week of warehouse-mapping bugs and silent schema breaks instead of shipping your product. Start the FlyByAPIs Mercadona API on the free tier: 100 requests a month, hard limit, no surprise bill. Most developers have their first product search back in under 5 minutes.