¿Buscas la Mercadona API? Esto es lo que existe de verdad

Si has buscado «Mercadona API», lo más probable es que quieras los productos y precios del supermercado en un formato que un programa o una hoja de cálculo pueda leer. Antes de elegir cómo conseguirlos, conviene saber qué hay realmente detrás de ese nombre.

Lo cierto es que no hemos encontrado una API pública oficial de Mercadona para desarrolladores. Lo que usan los proyectos de la comunidad es la interfaz interna de su tienda online (tienda.mercadona.es/api), que no está documentada, puede cambiar sin aviso y no es una vía respaldada por la empresa. Si solo necesitas sus productos y precios en una tabla, la https://www.octoparse.es/template/mercadona-scraper lo hace sin escribir código. Si quieres llevar los datos a tu propio código o a un asistente de IA, Octoparse ofrece además API, CLI y MCP.

¿Tiene Mercadona una API oficial?

Hemos buscado un portal para desarrolladores, un programa de socios o un anuncio de API pública de Mercadona y no hemos encontrado nada. Lo único que aparece es la integración con proveedores por EDI, un canal B2B para intercambiar pedidos y facturas que no sirve para consultar productos o precios.

Los proyectos de terceros que consultan el catálogo se presentan como no oficiales. El cliente en Elixir merca_ex explica que reutiliza los endpoints de la web “con fines educativos y personales”, y la documentación del repositorio datania/mercadona-catalog habla de una API “no oficial, observada en febrero de 2026”.

Que no la hayamos encontrado no es una declaración de Mercadona. Si necesitas una respuesta definitiva para un uso comercial, la vía fiable es preguntar a la empresa directamente.

La API interna de la tienda online: qué es y qué devuelve

La web de compra de Mercadona carga sus categorías y productos desde direcciones que devuelven JSON. Al consultar tienda.mercadona.es/api/categories/ nosotros mismos, la respuesta fue una lista de departamentos con sus subcategorías, sin iniciar sesión y sin indicar código postal.

La documentación de la comunidad describe, entre otras cosas:

• Un listado de categorías y el detalle de cada una.
• El detalle de un producto a partir de su identificador.
• Secciones de portada, como novedades o bajadas de precio.
• Un cambio de código postal, que determina el almacén asociado y, con él, el catálogo disponible.

No hay un endpoint que devuelva todos los productos de golpe. Los proyectos de la comunidad recorren las categorías una a una para reconstruir el catálogo.

Esta información procede de nuestra consulta puntual y de documentación de terceros. No es un contrato: Mercadona puede cambiar las rutas, los campos o las condiciones en cualquier momento.

Riesgos y condiciones de uso

• No es oficial ni está documentada. Una actualización de la web puede romper cualquier script sin previo aviso.
• El robots.txt de la tienda incluye una regla Disallow para /api. Puedes comprobarlo en tienda.mercadona.es/robots.txt.
• No hemos podido consultar las condiciones de uso de Mercadona. Antes de automatizar nada, lee el aviso legal de la web y valora si tu uso es compatible. Este artículo no constituye asesoramiento legal.
• Ritmo de consulta. Los proyectos serios de la comunidad espacian las peticiones (el de datania usa por defecto un solo proceso y una pausa de dos segundos) y aun así tardan horas en recorrer el catálogo.
• Cuentas, carritos y pedidos. No son datos de producto y no deben automatizarse.
• Datos no personales. Los productos y precios del catálogo no son datos personales. Si algún día mezclas estos datos con información de clientes, aplica el RGPD.

Mercadona API con Python: qué hace la comunidad

Quien programa suele montar un script que recorre las categorías y guarda el JSON. No vamos a incluir aquí código que consulte esas rutas, porque no son una vía oficial. Estos son los proyectos públicos que puedes revisar, cada uno con su licencia y sus advertencias:

• datania/mercadona-catalog: descarga el catálogo en JSON (licencia MIT) y documenta las rutas observadas.
• m0wer/mercaapi: una API REST no oficial que añade información nutricional e historial de precios.
• keess0/mcp-mercadona: un servidor MCP no oficial. Su propio README avisa de que los endpoints vienen de ingeniería inversa y que el uso automatizado podría incumplir las condiciones de Mercadona.

Si decides usar alguno, trátalo como un experimento personal y no como una dependencia de producción.

Mercadona Scraper: sacar los datos de productos sin código

La plantilla https://www.octoparse.es/template/mercadona-scraper de Octoparse recoge productos de la tienda online a partir de una o varias palabras clave y, si quieres, un código postal. Es gratuita y puedes ejecutarla en tu equipo o en la nube. No tienes que programar ni mantener ningún script.

Qué datos devuelve

Cómo usarla

1. Entra en la galería de plantillas de Octoparse y busca Mercadona Scraper.
2. Escribe las palabras clave (obligatorio), por ejemplo helado o aceite, y, si quieres, el código postal de tu zona. Los resultados pueden variar de una zona a otra.
3. Elige ejecutar en tu equipo o en la nube y espera a que termine la recopilación.
4. Cuando termine, exporta los datos a Excel, CSV o JSON.

Este es un ejemplo real con el código postal 08030 (Barcelona) y la palabra clave «helado». La plantilla devolvió 70 productos; aquí tienes los primeros. La búsqueda de la tienda también incluye otros productos relacionados, como postres o granizados, así que conviene filtrar el resultado antes de usarlo.

Cuando necesitas más de una zona o de un producto

Puedes introducir varias palabras clave a la vez y reunir todos los resultados en una sola hoja. Si quieres comparar zonas, lanza la misma búsqueda con distintos códigos postales: en nuestras pruebas con «helado», el 08030 devolvió 70 productos y el 46001 devolvió 74.

Si quieres que la consulta se repita cada día o cada semana, la ejecución en la nube (plan de pago) permite programarla y no depende de que tu ordenador esté encendido.

API, CLI y MCP de Octoparse: llevar los datos a tu código o a tu IA

Para llevar este tipo de recopilación a tus propios procesos, Octoparse ofrece tres vías para automatizar:

• API REST: para integrar las recopilaciones de Octoparse en tus procesos sin abrir la aplicación.
• CLI: para lanzar tareas desde la terminal o desde un cron.
• MCP: un servicio que conecta Octoparse con asistentes de IA como Claude, ChatGPT o Cursor, para pedir en lenguaje natural «busca helados con el código postal 08030» y recibir la tabla. Tienes una guía práctica de MCP con los pasos de conexión.

Si prefieres empezar sin plantilla, en la página de inicio de Octoparse puedes describir lo que necesitas al asistente de IA (en Beta). Ten en cuenta que puede recoger solo una parte de los datos y conviene revisar el resultado antes de usarlo.

¿Qué opción elegir?

Qué puedes hacer con los datos de Mercadona

• Comparar qué productos y precios aparecen en cada zona.
• Vigilar cambios de precio de los productos que más compras. Tienes más ideas en nuestra guía para automatizar el monitoreo de precios.
• Analizar la variedad de marcas propias y formatos de una categoría.
• Preparar un catálogo para un estudio, un trabajo académico o una herramienta propia.

Preguntas frecuentes sobre la Mercadona API

¿Existe una API oficial de Mercadona?

No hemos encontrado ninguna API pública oficial para desarrolladores ni un programa de socios. Lo que existe es la interfaz interna de la tienda online y canales B2B para proveedores.

¿Es legal usar la API de Mercadona?

Depende del uso y de las condiciones que acepte quien la utilice. No hemos podido consultar las condiciones de uso de Mercadona, y el robots.txt de la tienda incluye una regla Disallow para /api. Lee el aviso legal y, si tu uso es comercial, consulta con un abogado o con la empresa. Este contenido no es asesoramiento legal.

¿Hay que pagar por usar Mercadona Scraper?

La plantilla es gratuita. La ejecución programada en la nube forma parte de los planes de pago de Octoparse.

¿Para qué sirve el código postal?

La tienda online de Mercadona trabaja por zonas, así que el código postal sirve para consultar el catálogo de tu zona. En la plantilla es opcional y, en nuestras pruebas, el número de productos cambió de una zona a otra.

¿Puedo sacar los datos de Mercadona con Python?

Técnicamente hay proyectos que lo hacen, pero se apoyan en rutas internas no documentadas que pueden cambiar o dejar de funcionar. Si lo pruebas, hazlo a un ritmo bajo, sin automatizar cuentas ni pedidos, y revisa antes las condiciones de uso.

¿Puedo usar una IA para obtener los precios de Mercadona?

Sí. Con el MCP de Octoparse puedes pedir a un asistente como Claude o ChatGPT que ejecute la plantilla y te devuelva la tabla. También puedes describir lo que necesitas al asistente de IA de la página de inicio de Octoparse (Beta), aunque puede recoger solo una parte de los datos.

Conclusión

La Mercadona API oficial, tal como la buscan los desarrolladores, no aparece por ningún lado. Lo que sí hay es una interfaz interna que la comunidad aprovecha con riesgos claros, y una vía más estable para quien solo necesita los datos: una plantilla que devuelve productos y precios en una tabla. Elige según tu caso: tabla sin código, automatización por API o CLI, o pregunta en lenguaje natural con MCP.

Octoparse: Web Scraper Fácil para Todos

Descargar gratis

Registrarse

Convetir datos de sitios web en Excel, CSV, Google Sheets y base de datos directamente.

Scrapear datos fácilmente con funciones de Auto-Detectar, sin codificación.

Plantillas de crawler preestablecidas para sitios web populares para obtener datos en clics.

Nunca se bloquee con proxies IP y API avanzada.

Servicio en la Nube para programar la recopilación de datos en cualquier momento que desee.