Mercadona API

Mercadona's online shop as JSON: product search, categories, prices, unit prices, ingredients and allergens.

The API.SH Mercadona API returns Mercadona's (Spain) online shop as structured JSON. Browse the category tree, list every product in a subcategory, search products with brand and category filters, and read one product's price, previous price, unit price per kg or liter, EAN, brand, origin, ingredients, allergens and storage instructions. Prices follow the warehouse you choose, in Spanish or English.

Get a free API key Try it in the playground

4 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Mercadona product search

GET https://api.api.sh/mercadona/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Mercadona API

Grocery price tracking

Pull every product in a category with price, previous price, price-drop flag and unit price per kg or liter to track Mercadona prices over time.

/categories /category

Competitor and private-label analysis

Search a product type and compare brands, pack sizes and unit prices, using the brand counts the search returns.

/search

Nutrition and allergen apps

Read a product's ingredients, allergens, legal name, EAN and storage instructions to power diet, allergy or recipe apps.

/product

Regional price comparison

Request the same products for different warehouses to see how prices and availability differ across Spain.

/category /product

Shopping assistants and AI agents

Let an agent search Mercadona products and check price and availability before building a shopping list.

/search /product

Mercadona data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Mercadona API endpoints and prices

Every Mercadona endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Mercadona product search

/mercadona/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places2

Mercadona products in a category /mercadona/v1/category	$1 · $2 PAYG 1 credit
Mercadona product /mercadona/v1/product	$1 · $2 PAYG 1 credit

More data1

Mercadona category tree

/mercadona/v1/categories

$1 · $2 PAYG

1 credit

Call the Mercadona API

Mercadona product search: GET https://api.api.sh/mercadona/v1/search

curl "https://api.api.sh/mercadona/v1/search?q=leche" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/mercadona/v1/search",
    params={"q": "leche"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/mercadona/v1/search");
url.searchParams.set("q", "leche");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/mercadona/v1/search", "q", "leche")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Mercadona" and "Mercadona product search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Mercadona data

Public data only: no Mercadona login, cookies or account needed
One key and one response shape for Mercadona and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Mercadona API

Mercadona does not offer a public developer API. Community projects on GitHub document the online shop's internal endpoints, but they can change without notice. API.SH maintains access for you and returns products, prices and categories as stable JSON.

Rather than reverse-engineering tienda.mercadona.es yourself or running an Apify actor, call API.SH with one key at a fixed price per call; blocks and retries are handled for you.

Mercadona API questions

What Mercadona data can I get?+

The category tree (/mercadona/v1/categories), every product in a subcategory (/mercadona/v1/category), product search with brand and category filters (/mercadona/v1/search) and one product's full details with ingredients, allergens and EAN (/mercadona/v1/product).

How much does the Mercadona API cost?+

Every Mercadona endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /mercadona/v1/categories at 1 credit each.

Does Mercadona have an official API?+

No. Mercadona has no public API for developers. The unofficial wrappers on GitHub call the shop's internal endpoints and break when they change. API.SH keeps its Mercadona endpoints working and documented.

Do I need a Mercadona account or login?+

No. API.SH reads the public online shop only. No endpoint uses a login, cookies or anyone's account, and nothing is ordered.

Why do prices change by warehouse?+

Mercadona prices its online shop per warehouse, which depends on the delivery postcode area. Pass warehouse to get the prices and availability for that area.

Can I get product data in English?+

Yes. Set lang to en for English names and descriptions, or es (the default) for Spanish.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /mercadona/v1/search with q=leche. Every parameter is in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.