Cómo extraer datos de Mercado Libre México con una API: precios, vendidos, opiniones y preguntas

Para extraer datos de Mercado Libre México con una API, envía un POST a https://api.scavio.dev/api/v1/mercadolibre/search de la API de Mercado Libre de Scavio con {"country": "mx", "query": "freidora de aire"}. La respuesta trae 48 publicaciones de mercadolibre.com.mx, cada una con precio en pesos, precio anterior, descuento, cuotas, marca, calificación, número de opiniones, rango de unidades vendidas y envío. Cuesta 2 créditos por página, y con los ids de cada fila abres la ficha, las opiniones, las preguntas y el top 20 de más vendidos de la categoría.

La API oficial de Mercado Libre existe, pero está pensada para vendedores que trabajan con su propia cuenta: pide registrar una aplicación en el DevCenter, un flujo OAuth 2.0 con un usuario que la autorice y un access token que vence a las seis horas. Scavio devuelve los datos públicos de las publicaciones con una sola API key. Todo lo que sigue sale de respuestas reales capturadas el 2 de noviembre de 2026 en Mercado Libre México.

Lo que necesitas

• Una API key de Scavio. Al registrarte recibes 50 créditos gratis, sin tarjeta y sin cuenta de Mercado Libre.
• Cualquier lenguaje que haga peticiones HTTP. Los ejemplos usan cURL y Python.

Paso 1: busca publicaciones

curl -X POST 'https://api.scavio.dev/api/v1/mercadolibre/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"country": "mx", "query": "freidora de aire"}'

La búsqueda devolvió 48 publicaciones en 3.1 segundos, de un total de 11,326 repartidas en 42 páginas. Esta es la quinta fila, recortada y sin alterar ningún valor:

{
  "position": 5,
  "sponsored": false,
  "item_id": "MLM5286208502",
  "product_id": "MLM45051966",
  "title": "Freidora Aire Oster 7.5L DiamondForce 10 Programas",
  "url": "https://www.mercadolibre.com.mx/freidora-aire-oster-75l-diamondforce-10-programas/p/MLM45051966",
  "price": 1488,
  "original_price": 1969.03,
  "discount_percent": 24,
  "currency": "MXN",
  "installments": { "count": 24, "amount": 89.97, "interest_free": false },
  "seller": { "name": "Oster México", "official_store": true },
  "brand": "Oster",
  "rating": 4.9,
  "review_count": 773,
  "sold_quantity_min": 5000,
  "free_shipping": true,
  "full_fulfillment": true,
  "shipping_label": "Llega gratis mañana",
  "highlight": "MÁS VENDIDO",
  "category_id": "MLM456045",
  "domain_id": "MLM-AIR_FRYERS"
}

En esa página, 47 de 48 publicaciones salían con Full, 45 con envío gratis, 43 con descuento y 15 con meses sin intereses. 48 traían marca, 43 número de opiniones y 45 el mínimo de unidades vendidas. Los campos que más se usan:

La búsqueda acepta filtros de condition, min_price y max_price, min_discount, free_shipping, full_fulfillment, official_stores_only e interest_free_installments, y se ordena por relevancia o por precio con sort. Avanza con "page": 2 hasta total_pages. Detalles en la documentación de búsqueda.

Paso 2: abre la ficha del producto

curl -X POST 'https://api.scavio.dev/api/v1/mercadolibre/product' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"product_id": "MLM45051966"}'

No lleva country: el prefijo del id (MLM es México) lo define. Respuesta recortada:

{
  "product_id": "MLM45051966",
  "item_id": "MLM5286208502",
  "condition": "new",
  "sold_quantity_min": 5000,
  "sold_label": "+5 mil vendidos",
  "price": 1488.82,
  "original_price": 1969.03,
  "currency": "MXN",
  "installments": { "count": 24, "amount": 89.97, "total": 2159.28, "interest_free": false },
  "rating": {
    "average": 4.9,
    "count": 773,
    "distribution": { "1": 7, "2": 4, "3": 5, "4": 34, "5": 723 },
    "with_comment": 472,
    "with_photos": 408,
    "with_videos": 99
  },
  "seller": {
    "name": "Oster México",
    "reputation_level": "5_green",
    "power_seller_status": "platinum",
    "store_type": "OFFICIAL_STORE",
    "sales_label": "+1 M ventas"
  },
  "stock": { "available": true, "available_label": "+50 disponibles" },
  "shipping": { "free_shipping": true, "logistic_type": "fulfillment", "mode": "me2" },
  "best_seller_position": 3
}

La ficha también trae 14 especificaciones (marca, modelo, medidas), la descripción, 9 imágenes, las variaciones con sus ids y la ruta de categorías. Fíjate en el precio: la búsqueda mostró $1,488 y la ficha $1,488.82, porque la tarjeta de búsqueda redondea. Si guardas precios para comparar, toma siempre el mismo endpoint. Más campos en la documentación de producto.

Paso 3: lee las opiniones

curl -X POST 'https://api.scavio.dev/api/v1/mercadolibre/reviews' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"product_id": "MLM45051966"}'

Cada página trae 15 opiniones por 1 crédito. La primera, recortada a dos de sus cinco fotos:

{
  "review_id": 2959696523,
  "rating": 5,
  "text": "Diseño: es idéntica a la de la imagen.\nCocción: los alimentos súper bien.\nSin duda la volvería a comprar, es muy práctica y rápida.",
  "original_text": null,
  "translated": false,
  "created_at": "2026-06-17T02:31:18Z",
  "likes": 18,
  "country": "mx",
  "reviewer_country": "México",
  "media": [
    { "type": "video", "url": "https://http2.mlstatic.com/D_NQ_NP_6a3206e7e081b9f6cb73e4d2-O.webp" },
    { "type": "photo", "url": "https://http2.mlstatic.com/D_NQ_NP_716876-MLA113374317983_062026-F.jpg" }
  ]
}

Agrega "rating": 1 para ver solo las de una estrella. En los productos de catálogo, Mercado Libre junta opiniones de varios países y las traduce; original_text conserva el texto original y country dice dónde se escribió. Las 15 de esta freidora eran de México. Ver la documentación de opiniones.

Paso 4: extrae las preguntas de los compradores

curl -X POST 'https://api.scavio.dev/api/v1/mercadolibre/questions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"item_id": "MLM5286208502"}'

La primera página trajo 20 preguntas, las 20 con respuesta de Oster México, respondidas entre el 24 de septiembre y el 2 de noviembre de 2026. Una de ellas:

{
  "question_id": 13680487102,
  "text": "Podrían indicarme si el recubrimiento contiene PTFE o PFAS?",
  "answer": {
    "text": "Hola. Te informamos que la freidora de aire Oster de 7.5L con recubrimiento DiamondForce contiene PTFE, pero está certificada como libre de PFOA. Aguardamos tu compra, saludos.",
    "date": "2026-10-24"
  }
}

Para la página siguiente, pasa el next_offset de la respuesta (aquí 20) como offset. Las preguntas son una fuente directa de dudas antes de comprar: en esta publicación se repetían el voltaje (127 V o 220 V), el temporizador y si el recubrimiento lleva PTFE. Ver la documentación de preguntas.

Paso 5: saca el top 20 de más vendidos de la categoría

curl -X POST 'https://api.scavio.dev/api/v1/mercadolibre/best-sellers' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"country": "mx", "category_id": "MLM456045"}'

El category_id sale de la búsqueda o de la ficha. Para "De Aire" (Electrodomésticos > Pequeños Electrodomésticos > Para Cocina > Preparación de Alimentos > Freidoras), la lista trajo 20 productos con precio, descuento, cuotas, calificación y rango de vendidos. Oster ocupaba los lugares 1, 2, 3, 4, 6 y 14, Ninja los 9, 11, 13 y 15, y la mediana de precio del top 20 fue de $1,418.50. Dos de los 20 eran forros de papel desechable, no freidoras: la lista es la de Mercado Libre, tal cual. Ver la documentación de más vendidos.

Todos los endpoints de Mercado Libre México

Los cinco funcionan igual en Argentina (ar) y Colombia (co); en Brasil (br) funcionan todos menos más vendidos.

Límites que conviene conocer

• Las unidades vendidas son rangos, nunca cifras exactas: sold_quantity_min es el piso del rango que muestra Mercado Libre.
• Una búsqueda llega a 42 páginas, unos 2,000 resultados. Para ir más a fondo, divide por rango de precio, condición o vendedor.
• El orden es por relevancia o por precio. Mercado Libre no ofrece orden por más nuevos ni por más vendidos; para eso está el endpoint de más vendidos.
• La ficha devuelve el vendedor del buy box, no la lista de todos los vendedores de un producto.
• Solo datos públicos: nada de datos de contacto de compradores o vendedores.

Cuánto cuesta

Búsqueda, producto, preguntas y más vendidos cuestan 2 créditos; opiniones, 1. En el plan Growth con pago anual (US$2 por 1,000 créditos), una página de 48 publicaciones cuesta US$0.004. Revisar a diario 50 búsquedas de 2 páginas son 200 créditos al día, unos 6,000 al mes: US$12 a esa tarifa, y caben en el plan más pequeño, de US$30 al mes por 7,000 créditos. Ver precios.

Empieza

1. Crea tu cuenta y prueba la API de Mercado Libre gratis: 50 créditos, sin tarjeta.
2. Copia tu API key del dashboard y corre la búsqueda del paso 1 con tu propio producto.
3. Guarda item_id y product_id de las filas que te interesan y úsalos en ficha, opiniones y preguntas.
4. Programa las llamadas y guarda cada respuesta con su fecha para ver cómo cambian precios y vendidos.

La página de la API de Mercado Libre tiene una prueba en vivo sin registro. Si comparas proveedores para hacer scraping en Argentina, lee las mejores APIs para scraping de Mercado Libre Argentina. La misma key funciona con la API de Amazon y la API de Walmart, ambas con México, y con la API de HEB México.