Mercado Libre Scraper — Products, Sellers & Sales 🚀

Scrape Mercado Libre and Mercado Livre (MercadoLibre) in all 18 Latin American countries in a single run. Search by keyword, or paste product, category or store URLs, and get 45+ fields per product: price and discount, units sold, seller reputation, MercadoLíder level, official store, FULL shipping, specs, variants, structured reviews, installments and price in USD.

🇪🇸 Versión en español más abajo

✨ What you get

• 🌎 18 countries in one run: Mexico, Brazil, Argentina, Colombia, Chile, Peru and 12 more.
• 🎯 4 kinds of input, mixed freely and auto-detected: keyword, product URL, category/listing URL and store/seller URL.
• 📈 Units sold and search position for every product.
• 👤 Seller data: reputation (5_green), MercadoLíder (silver/gold/platinum) and official store.
• 🏪 Store mode: store profile (name, followers, type, official) plus its whole catalog.
• 🚚 FULL shipping (Mercado Envíos Full) and free shipping flags.
• 🧾 Specs, variants and structured reviews (stars, text, date, country, likes, photos).
• 💵 Price in USD with daily exchange rates to compare countries.
• ⚡ Fast listing mode for cheap, large-scale price monitoring.
• 🛡️ Built for Mercado Libre's anti-bot wall: real browser identity, a clean session per visitor and automatic IP rotation.

💡 Use cases

• Price monitoring: track your products and your competitors' prices every day.
• Market research: find best-selling products and top sellers in any category, with units sold.
• Seller and brand analysis: export an official store's full catalog with prices and sales.
• Cross-country comparison: compare the same product in several countries in USD.

🚀 Quick start

Search by keyword

{ "busqueda": "iphone 15", "paises": ["MX", "BR", "AR"], "maxItems": 50 }

Direct URLs (product / category / store)

{
  "startUrls": [
    "https://www.mercadolibre.com.mx/apple-iphone-15-256-gb-negro/p/MLM27172669",
    "https://listado.mercadolibre.com.ar/celulares",
    "https://www.mercadolibre.com.mx/tienda/apple"
  ]
}

Fast price monitoring (listing only)

{ "busqueda": "laptop gaming", "paises": ["MX"], "soloListado": true, "maxItems": 500 }

With price in USD

{ "busqueda": "notebook", "paises": ["MX", "BR"], "convertirUSD": true, "maxItems": 30 }

⚙️ Input

Field	Type	Description
busqueda	string	Search term. Leave empty if you only use startUrls.
startUrls	array	Product / category / store URLs (auto-detected; the country comes from the domain).
paises	array	Countries for the keyword search (18 available).
soloListado	boolean	Fast mode: listing cards only, without opening each product.
traducirColumnas	boolean	Portuguese column names and values for Brazil. Off = consistent Spanish columns.
maxReviews	integer	Detailed reviews per product (0 turns them off).
convertirUSD	boolean	Adds precio_usd using daily exchange rates.
tasasUSD	object	Optional manual rates, e.g. {"MXN": 0.058}.
maxItems	integer	Max products per country (0 = no limit).
maxConcurrency	integer	Pages in parallel (1–5).
separarDatasetsPorPais	boolean	Also saves one JSON file per country in the key-value store.
proxyConfiguration	object	Apify Proxy (residential recommended).
externalProxies	array	Your own proxies (optional).

📋 Output (45+ fields)

Field names are in Spanish so every country shares the same columns.

Row: tipo_fila (producto or perfil_tienda), pais_origen, fecha_scrape, posicion, categoria Identity: titulo, url, product_id, sku, marca, modelo, condicion Prices: precio_actual, precio_original, descuento_porcentaje, moneda, precio_usd, cuotas, cuotas_detalle Stock and sales: stock, cantidad_disponible, cantidad_vendida (units sold) Seller: vendedor, tienda_oficial, tienda_oficial_nombre, reputacion_vendedor, mercadolider Store profile: nombre_tienda, seguidores, tipo_tienda Shipping: envio, envio_gratis, envio_full, envio_tipo Product page: descripcion, caracteristicas, especificaciones [{nombre, valor}], variantes [{tipo, seleccion, opciones}], variaciones, imagenes Reviews / Q&A: estrellas, reviews_count, reviews_texto, reviews_detalle [{estrellas, texto, fecha, pais, likes, media}], preguntas

Example row (shortened):

{
  "titulo": "Celular Samsung Galaxy A07 Verde 128GB",
  "precio_actual": 2373.0,
  "moneda": "MXN",
  "cantidad_vendida": 1000,
  "vendedor": "samsung",
  "tienda_oficial": true,
  "estrellas": 4.9,
  "categoria": "Celulares y Telefonía > Celulares y Smartphones > Celular",
  "product_id": "MLM68588180",
  "pais_origen": "MX"
}

🏪 Store mode

Paste a store URL (/tienda/..., /perfil/...) in startUrls and you get:

1. A profile row (tipo_fila: perfil_tienda) with nombre_tienda, seguidores, tipo_tienda and tienda_oficial.
2. The store's catalog, up to maxItems, with the full product page of each product.

{ "startUrls": ["https://www.mercadolibre.com.mx/tienda/apple"], "maxItems": 50 }

💰 Pricing

Pay per event, no monthly fee. Platform usage (compute and proxy) is included.

Event	What it is	Price
Product with detail	One full product page (seller, units sold, specs, reviews…)	$6.00 per 1,000
Listing product	One card in soloListado mode	$2.00 per 1,000
Actor start	Once per run	$0.00005

You only pay for rows with a title and a price above 0: incomplete or paused listings and the store profile row are free. If you set a spending limit for the run, the Actor stops when it reaches it.

🌎 Supported countries

Argentina, Bolivia, Brazil, Chile, Colombia, Costa Rica, Dominican Republic, Ecuador, Guatemala, Honduras, Mexico, Nicaragua, Panama, Paraguay, Peru, El Salvador, Uruguay and Venezuela.

💡 Performance and blocking

Mercado Libre blocks datacenter IPs and shows an anti-bot challenge. This Actor uses a browser with its real identity (Mercado Libre blocks made-up fingerprints), a separate session per visitor, locale and time zone matching the country, and rotates IP automatically when it gets blocked. Product pages are processed in batches: the browser opens the first one and fetches the rest inside the same session, about 200 KB per product instead of 3 MB. Always use residential proxies.

⚠️ Notes

• Seller reputation, MercadoLíder, units sold and official store come from Mercado Libre's page data; availability depends on each listing.
• envio (text) is a dynamic delivery promise (it depends on the time, the proxy location and the session). For stable signals use envio_gratis and envio_full.
• preguntas: Mercado Libre no longer shows questions on the public product page, so it is usually empty.
• soloListado mode does not include the full product page (specs, reviews, detailed seller).

---

🇪🇸 Versión en español

Scraper de Mercado Libre y Mercado Livre para los 18 países de Latinoamérica en una sola corrida. Busca por keyword o pega URLs de producto, categoría o tienda, y obtén 45+ campos por producto: precio y descuento, cantidad vendida, reputación del vendedor, MercadoLíder, tienda oficial, envío FULL, specs, variantes, reseñas estructuradas, cuotas y precio en USD.

✨ Qué obtienes

• 🌎 18 países en una sola corrida, con traducción opcional de columnas a portugués para Brasil.
• 🎯 4 formas de entrada, combinables y auto-clasificadas: keyword, URL de producto, URL de categoría/listado y URL de tienda/vendedor.
• 📈 Cantidad vendida y posición en los resultados.
• 👤 Datos de vendedor: reputación (5_green), MercadoLíder (silver/gold/platinum) y tienda oficial.
• 🏪 Modo tienda: perfil de la tienda (nombre, seguidores, tipo, oficial) más su catálogo completo.
• 🚚 Envío FULL (MercadoEnvíos Full) y envío gratis.
• 🧾 Specs, variantes y reseñas estructuradas (estrellas, texto, fecha, país, likes y fotos).
• 💵 Precio en USD con tasas del día para comparar entre países.
• ⚡ Modo listado rápido para monitoreo de precios masivo y barato.
• 🛡️ Hecho para el muro anti-bot de Mercado Libre: identidad de navegador real, una sesión limpia por visitante y rotación de IP automática.

💡 Casos de uso

• Monitoreo de precios: sigue tus productos y los de tu competencia todos los días.
• Investigación de mercado: encuentra lo más vendido y los mejores vendedores de cualquier categoría.
• Análisis de vendedores y marcas: exporta el catálogo completo de una tienda oficial con precios y ventas.
• Comparación entre países: compara el mismo producto en varios países en USD.

🚀 Inicio rápido

Los ejemplos de entrada son los mismos de la sección en inglés: busqueda + paises, startUrls (producto, categoría o tienda), soloListado para el modo rápido y convertirUSD para el precio en dólares.

⚙️ Parámetros de entrada

Campo	Tipo	Descripción
busqueda	string	Término a buscar. Vacío si solo usas startUrls.
startUrls	array	URLs de producto / categoría / tienda (auto-clasificadas; el país se detecta del dominio).
paises	array	Países para la búsqueda por keyword (18 disponibles).
soloListado	boolean	Modo rápido: solo tarjetas del listado, sin entrar a cada producto.
traducirColumnas	boolean	Columnas y valores en portugués para Brasil. Apagado = columnas consistentes en español.
maxReviews	integer	Reseñas detalladas por producto (0 las desactiva).
convertirUSD	boolean	Agrega precio_usd con tasas del día.
tasasUSD	object	Tasas manuales opcionales, ej. {"MXN": 0.058}.
maxItems	integer	Máx. productos por país (0 = sin límite).
maxConcurrency	integer	Páginas en paralelo (1–5).
separarDatasetsPorPais	boolean	Guarda además un JSON por país en el key-value store.
proxyConfiguration	object	Proxies de Apify (residenciales recomendados).
externalProxies	array	Proxies externos propios (opcional).

📋 Campos de salida

Son los mismos de la sección en inglés (los nombres ya están en español). En Brasil, con traducirColumnas: true, las columnas y valores salen en portugués (preco_atual, condicao, Novo, frete_full, etc.).

💰 Precio

Pago por evento, sin cuota mensual. El uso de plataforma (cómputo y proxy) ya está incluido.

Evento	Qué es	Precio
Producto con detalle	Una ficha completa (vendedor, vendidos, especificaciones, reseñas…)	$6.00 por 1,000
Producto de listado	Una tarjeta del modo soloListado	$2.00 por 1,000
Inicio del Actor	Una vez por corrida	$0.00005

Solo se cobran filas con título y precio mayor a 0: las fichas incompletas o pausadas y la fila de perfil de tienda no se cobran. Si pones un límite de gasto a la corrida, el Actor se detiene al alcanzarlo.

⚠️ Notas

• La reputación del vendedor, MercadoLíder, cantidad vendida y tienda oficial salen de los datos de la página de Mercado Libre; su disponibilidad depende de cada publicación.
• El campo envio (texto) es una promesa de entrega dinámica (depende de la hora, la ubicación del proxy y la sesión); para señales estables usa envio_gratis y envio_full.
• preguntas: Mercado Libre ya no publica las preguntas en la ficha pública, así que normalmente viene vacío.
• El modo soloListado no incluye la ficha completa (specs, reseñas, vendedor detallado).

---

Commercial use allowed / Uso comercial permitido. This Actor is not affiliated with Mercado Libre and only extracts data from public pages. You are responsible for complying with Mercado Libre's terms of service and applicable data laws. / Este Actor no está afiliado a Mercado Libre y solo extrae datos de páginas públicas. El usuario es responsable de cumplir los términos de servicio de Mercado Libre y la normativa de datos aplicable.