API de Mercado Libre

Mercado Libre tiene una API oficial para desarrolladores construida sobre OAuth 2.0: registras una aplicación en el DevCenter de Mercado Libre, un usuario de Mercado Libre la autoriza y cada llamada lleva el access token de ese usuario, que vence a las seis horas y hay que renovar. Está pensada para vendedores e integradores que trabajan con sus propias cuentas. La API de Mercado Libre de Scavio devuelve datos públicos de publicaciones con una sola API key, sin app ni OAuth: búsqueda, producto, opiniones, preguntas y más vendidos, 5 endpoints a 2 créditos cada uno (opiniones 1).

El 403 viene de la API oficial de Mercado Libre, y su documentación para desarrolladores es el lugar para diagnosticar un rechazo concreto. Lo que aplica a todas las llamadas: a octubre de 2026, esa API exige una aplicación OAuth registrada en el DevCenter de Mercado Libre y un access token de un usuario que haya autorizado esa app. Si lo que necesitas son datos públicos de publicaciones, la API de Mercado Libre de Scavio funciona con una API key, sin app ni token de usuario: búsqueda, producto, opiniones, preguntas y más vendidos para publicaciones públicas de México, Brasil, Argentina y Colombia. Qué exige la API oficial y un ejemplo sin OAuth con resultados reales (en inglés).

No para Scavio. Una API key de Scavio cubre los 5 endpoints en los cuatro países, sin app en el DevCenter, sin client ID ni client secret y sin renovar el token cada seis horas. Las cuentas nuevas reciben 50 créditos gratis al registrarse, sin tarjeta.

México (mx), Brasil (br, Mercado Livre), Argentina (ar) y Colombia (co). Búsqueda, producto, opiniones y preguntas funcionan en los cuatro; más vendidos funciona en México, Argentina y Colombia, pero no en Brasil. Chile no está soportado. Para producto, opiniones y preguntas el país sale del prefijo del id (MLM México, MLB Brasil, MLA Argentina, MCO Colombia) o de la URL.

Con la API de Scavio no hay scraper que mantener: envías un POST con un país y una búsqueda, un id de producto o una categoría, y recibes JSON estructurado con los mismos nombres de campo en todos los países. Búsqueda, ficha de producto, opiniones, preguntas y más vendidos están cubiertos desde 1 crédito por llamada, sin registrar una app ni pedir autorización a un usuario.

Solo como el rango que muestra Mercado Libre. sold_quantity_min es un mínimo (1000 para "+1000 vendidos") y sold_label trae el texto tal como aparece. Mercado Libre muestra las ventas en rangos, así que no se devuelve un número exacto. En la búsqueda capturada de iPhone 15 los rangos fueron de 25 a 10,000.

Sí. Cada resultado trae brand, rating y review_count, leídos de la misma página de resultados, así que seguir marcas y totales de opiniones en toda una búsqueda cuesta 2 créditos por página, sin una llamada a producto por publicación. El 16 de octubre de 2026, una búsqueda de "fone bluetooth" en Mercado Livre devolvió marca en los 48 resultados orgánicos y número de opiniones en 43. La cobertura de review_count varía según la búsqueda (17 de 48 para "iphone 15" en México, donde muchos resultados son reacondicionados) y es null, nunca 0, cuando la página no publica un total. La mayoría de los resultados patrocinados devuelven review_count null. En Colombia solo el primer resultado los trae.

Los precios vienen en la moneda local del sitio: MXN, BRL, ARS o COP, con la moneda en cada resultado. Cada publicación trae price, original_price y discount_percent cuando está en oferta, y el plan de cuotas (count, amount y un indicador interest_free para meses sin intereses o cuotas sin interés). La búsqueda filtra por min_price, max_price y min_discount, y ordena por precio ascendente o descendente, lo que la vuelve una API práctica para precios de Mercado Libre. En Brasil, el precio de un resultado de búsqueda suele ser el precio con Pix, cerca de 5% por debajo del precio normal; el endpoint de producto devuelve el precio normal y suele listar la oferta con Pix en promotions. El 11 de octubre de 2026 un iPhone 15 mostraba R$4,009 en la búsqueda y R$4,220.84 en el endpoint de producto.

Sí. Opiniones devuelve 15 por página por 1 crédito, filtrables por estrellas, con texto, fecha exacta, likes, fotos y el país donde se escribió cada opinión; las traducidas conservan el texto original. Preguntas devuelve las preguntas de compradores con la respuesta del vendedor y la fecha de respuesta. Mercado Libre no muestra la fecha de la pregunta, así que no se devuelve. El total de opiniones y la distribución de estrellas vienen con el endpoint de producto (en Brasil suele no traer la distribución). Las opiniones de catálogo se juntan entre países: el 11 de octubre de 2026, 10 de las 12 opiniones de la primera página del iPhone 15 mexicano se escribieron en Brasil y estaban traducidas, con el original en portugués.

Sí, en México, Argentina y Colombia. Más vendidos devuelve el top 20 de una categoría con precio, descuento, cuotas, calificación y unidades vendidas. Toma el category_id de una respuesta de búsqueda o de producto; su prefijo debe coincidir con el país. La lista de más vendidos de Brasil no está disponible.

Unas 48 publicaciones por página y hasta 42 páginas, es decir, unos 2,000 resultados por búsqueda. Cada respuesta trae total y total_pages. Para ir más a fondo, divide la búsqueda por rango de precio, condición o vendedor y haz una búsqueda por segmento. El orden es por relevancia o por precio; Mercado Libre no ofrece orden por más nuevos ni por más vendidos.

Sí. La búsqueda acepta un seller_id (el id numérico que el endpoint de producto devuelve para el vendedor del buy box) y lo combina con una búsqueda, todos los filtros, el orden y la página. Un seller_nickname devuelve la primera página de publicaciones del vendedor y su seller_id. Solo se devuelven datos públicos de publicaciones, nunca datos de contacto del vendedor.

Búsqueda, producto, preguntas y más vendidos cuestan 2 créditos por llamada; opiniones cuesta 1. En el plan Growth con pago anual (US$2 por 1,000 créditos) son US$0.004 por página de búsqueda de unas 48 publicaciones, cerca de US$0.08 por 1,000 publicaciones, y US$0.002 por página de 15 opiniones. Un producto, publicación o vendedor que no existe devuelve 404 y se cobra; las fallas temporales no se cobran. Las cuentas nuevas reciben 50 créditos gratis sin tarjeta, y los planes pagos empiezan en US$30 al mes por 7,000 créditos.

Scavio devuelve datos públicos de Mercado Libre: lo que cualquiera puede ver en una página pública de Mercado Libre, como publicaciones, precios, opiniones y preguntas respondidas. No devuelve datos de contacto de compradores o vendedores ni nada que esté detrás de un inicio de sesión. Si tu uso específico está permitido depende de tu jurisdicción, tu caso de uso y los términos de Mercado Libre, y tú eres responsable de cómo usas los datos. Esto no es asesoría legal; consulta a tu propio abogado.

Cada solicitud lee Mercado Libre en vivo en el momento de la llamada, así que los cambios de precio, las publicaciones nuevas y las opiniones nuevas aparecen en cuanto Mercado Libre las muestra. Nada sale de una copia en caché. Para seguir precios en el tiempo, guarda las respuestas de forma programada y compáralas.