API MercadoLibre: lo que no te cuentan

Buscas datos de MercadoLibre —precios, stock, reseñas o listados de competidores— y llegas a la documentación oficial de la API. Ves Client ID, Client Secret, OAuth, verificación de titular de cuenta… y cierras la pestaña. Te preguntas si existe una forma más rápida.

En este artículo revisamos qué puedes hacer realmente con la API oficial de MercadoLibre, qué límites no aparecen escritos con claridad en la documentación, y cuándo conviene más usar web scraping sin código. Así podrás decidir cuál te conviene según lo que necesitas extraer.

¿Qué es la API de MercadoLibre y qué puedes hacer con ella?

La API de MercadoLibre es la interfaz REST oficial que permite a desarrolladores y vendedores conectar sus propios sistemas con la plataforma. No es un botón de “exportar datos”: es un conjunto de endpoints que debes integrar en tu propio código.

Con ella puedes trabajar, entre otras cosas, con:

• Usuarios y datos de cuenta
• Ítems y búsquedas de productos
• Pedidos, pagos y envíos
• Preguntas y respuestas de publicaciones
• Opiniones y calificaciones de productos
• Categorías, atributos y ubicaciones

Un dato curioso: MercadoLibre ya ofrece un MCP Server oficial, pensado para que agentes de IA consulten su documentación y sus recursos en lenguaje natural. Es una señal de hacia dónde va la plataforma, aunque —como veremos— necesitas una cuenta de Mercado Libre y autorizar el acceso mediante OAuth 2.0.

Cómo funciona el acceso: registro, OAuth y verificación de cuenta

Crea una aplicación (Client ID y Secret Key)

Antes de llamar a cualquier endpoint necesitas crear una aplicación en “Mis aplicaciones” (DevCenter). Ahí obtienes un Client ID y un Client Secret, y defines los scopes (lectura y/o escritura) y las URIs de redirect para el flujo OAuth. Se recomienda además activar PKCE para reforzar la seguridad del intercambio de tokens.

Verificación de titularidad en Argentina, México, Brasil y Chile

En estos cuatro países, MercadoLibre solo permite crear una aplicación después de validar los datos del titular de la cuenta, y esa información debe coincidir exactamente con la registrada. Si no coincide, el proceso se traba y hay que contactar a soporte.

Nueva regla 2026: aplicaciones separadas para MercadoLibre y MercadoPago

A partir del 30 de agosto de 2026, cada aplicación debe pertenecer a una sola unidad de negocio: MercadoLibre o MercadoPago, no ambas. Las aplicaciones que mezclen scopes de los dos productos y no se adecúen pierden el acceso a las APIs. Es un ajuste de compliance más que hay que gestionar antes de poder empezar a consumir datos.

Límites de la API de MercadoLibre: rate limit, scroll_id y cuota

La documentación oficial no publica un número único de “peticiones permitidas”. Según su guía de rate limit y error 429, el límite se aplica principalmente por Client ID (tu aplicación) y por endpoint, no por el tamaño de lo que pides. Cuando lo superas, la API responde con un error 429 (Too Many Requests).

Otros puntos que conviene conocer antes de diseñar una integración:

• Las búsquedas paginadas con scroll_id expiran: si no consumes las páginas a tiempo, empiezas a recibir errores 429
• No se puede combinar scroll_id con offset/limit en la misma petición: hay que elegir un solo mecanismo de paginación
• Si necesitas más cuota, no hay un botón de autoservicio: hay que solicitar el aumento al equipo comercial con evidencia de uso

En la práctica, esto significa que un proyecto de análisis puntual —por ejemplo, comparar precios de 200 productos una sola vez— puede chocar con estos límites mucho antes de lo esperado si no se diseña con backoff y control de concurrencia.

¿La API te deja extraer reseñas y comentarios de productos?

Sí, existe un endpoint específico de opiniones: GET /reviews/item/$ITEM_ID. Devuelve el rating_average, la distribución por estrellas (rating_levels) y el contenido de las opiniones individuales (título, texto, calificación, fecha de compra).

Tres detalles importantes antes de usarlo:

• Requiere un Bearer Token, es decir que no es un endpoint público: hay que completar todo el flujo OAuth descrito arriba solo para leer reseñas
• El campo reviewer_id siempre devuelve 0: no es posible identificar quién escribió cada opinión
• Solo funciona con ítems activos y publicados, y devuelve las opiniones de 5 en 5 por defecto (parámetros offset y limit), así que una consulta masiva exige paginar y vigilar el rate limit

Si lo que buscas es justamente extraer comentarios y reseñas sin pasar por el registro de una aplicación ni por OAuth, ya cubrimos ese caso en detalle en cómo extraer comentarios de MercadoLibre con una plantilla gratuita.

API vs Scraping: ¿cuál conviene?

Extrae datos de MercadoLibre sin código con Octoparse

Si tu caso es el segundo grupo de la tabla anterior, no necesitas pasar por nada de lo descrito arriba. Octoparse permite extraer datos públicos de MercadoLibre —precios, listados, detalles de producto, reseñas— sin crear una aplicación ni gestionar tokens de desarrollador.

Diferencias entre la API de MercadoLibre y Octoparse

Octoparse ya cuenta con plantillas preconfiguradas para MercadoLibre, como MercadoLibre Listados Scraper(con URL), que extrae los productos de una página de resultados a partir de su URL. Funciona sin el proceso de registro de aplicación, verificación de titular ni configuración de OAuth que exige la API oficial: creas una cuenta gratuita y en minutos tienes los datos.

https://www.octoparse.es/template/mercadolibrelistados-scraper-con-url

Estos son algunos de los campos que devuelve la plantilla:

Si además quieres vigilar los precios de la competencia de forma recurrente, consulta cómo automatizar el monitoreo de precios sin hacerlo a mano.

Octoparse MCP Server: pide los datos en lenguaje natural desde tu chat de IA

Al igual que MercadoLibre, Octoparse tiene su propio MCP Server, compatible con Claude, ChatGPT, Gemini CLI, VS Code y otros agentes de IA. La diferencia es que aquí no hay que registrar ninguna aplicación: describes lo que necesitas en lenguaje natural directamente en el chat —por ejemplo, “dame el precio y las reseñas de estos 10 productos de MercadoLibre“— y recibes los datos estructurados sin salir de la conversación.

Los resultados se exportan directamente a JSON, CSV o XLSX, listos para tu análisis. Si prefieres automatizar desde código o desde la terminal, Octoparse también ofrece una API REST y una CLI.

Preguntas frecuentes

¿Qué es la API de MercadoLibre?

Es la interfaz REST oficial de MercadoLibre que permite a desarrolladores y vendedores conectar sus sistemas con la plataforma. Con ella puedes leer o escribir datos de usuarios, productos, pedidos, pagos, envíos, preguntas y reseñas, siempre que autentiques tu aplicación con OAuth y respetes sus límites de uso.

¿Cómo usar la API de MercadoLibre?

Primero creas una aplicación en “Mis aplicaciones” (DevCenter) para obtener tu Client ID y Client Secret. Después configuras el flujo OAuth (scopes, URIs de redirect y, opcionalmente, PKCE) para generar un Bearer Token. Con ese token llamas a los endpoints que necesites, como búsquedas, pedidos o reseñas, respetando el rate limit de tu aplicación.

¿Cuánto cuesta usar la API de MercadoLibre?

Registrar una aplicación y usar los endpoints básicos no tiene costo económico. El costo real está en el tiempo de integración: crear la aplicación, verificar la titularidad de la cuenta en algunos países, implementar OAuth, gestionar el rate limit y, si tu volumen crece, solicitar más cuota al equipo comercial.

¿Es legal hacer scraping de MercadoLibre?

En general, extraer información pública de un sitio web es legal, pero depende del país, del tipo de datos y de los términos de uso de la plataforma. Evita recopilar datos personales, mantén un ritmo de extracción razonable y revisa las condiciones de MercadoLibre antes de automatizar. Más contexto en nuestra guía sobre si el web scraping es legal.

¿Puedo extraer datos de MercadoLibre sin usar la API oficial?

Sí. Las herramientas de web scraping sin código, como Octoparse, extraen datos públicos de MercadoLibre (precios, listados, detalles de producto y reseñas) a partir de una URL, sin crear una aplicación ni pasar por OAuth. Puedes usar plantillas listas o pedir los datos en lenguaje natural con el MCP Server de Octoparse, y exportarlos a Excel, CSV o JSON.

Conclusión

La API oficial de MercadoLibre es sólida para quien va a construir una integración propia a largo plazo, pero no es la vía rápida que muchos buscan: exige registro, OAuth, verificación de cuenta y convivir con límites de peticiones que solo se amplían bajo solicitud. Si tu necesidad es puntual —analizar precios, listados o reseñas de terceros— el scraping sin código es, en la mayoría de los casos, el camino más corto.

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.