Mercado Libre Multi-Country Scraper 🛒 7 LATAM Marketplaces (BR, MX, AR, CL, CO, PE, UY)

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

Scrape product listings from Mercado Libre / Mercado Livre across 7 Latin American marketplaces — Brazil, Mexico, Argentina, Chile, Colombia, Peru, and Uruguay — with a single Actor. Pick a country and the scraper targets its native domain, locale, and currency automatically. Extract product details, pricing, seller data, shipping info, reviews, and categories. No API key needed.

✨ Features

• 🌎 7 LATAM countries in one Actor — BR, MX, AR, CL, CO, PE, UY, each on its native Mercado Libre domain
• 💱 Country-aware currency & locale — Prices returned in the marketplace's real currency (BRL, MXN, ARS, CLP, COP, PEN, UYU)
• 🛒 Product search — Any keyword on the selected country's marketplace
• 💰 Full pricing — Price, original price, discount percentage, currency
• 🏪 Seller data — Nickname, plus units sold when the product page shows a "N vendidos" line (requires includeDetails)
• 🚚 Free-shipping flag — Boolean, read from the search card
• ⭐ Reviews & categories — Rating, review count, and up to 3 breadcrumb levels (requires includeDetails)
• ⚡ Cost/speed toggle — includeDetails=false (default) returns fast search-only data; enable it for deep per-product enrichment
• 🌐 Geo-aware proxy — Uses Apify Residential proxy in the target country (Mercado Libre geo-blocks foreign IPs)

🌍 Supported Countries

Code	Marketplace	Domain	Currency
BR	Brazil	mercadolivre.com.br	BRL
MX	Mexico	mercadolibre.com.mx	MXN
AR	Argentina	mercadolibre.com.ar	ARS
CL	Chile	mercadolibre.cl	CLP
CO	Colombia	mercadolibre.com.co	COP
PE	Peru	mercadolibre.com.pe	PEN
UY	Uruguay	mercadolibre.com.uy	UYU

📥 Input

Parameter	Type	Default	Description
country	string	"BR"	Target marketplace: BR, MX, AR, CL, CO, PE, UY
searchQuery	string	(required)	Search term (e.g. "iphone 15", "notebook samsung")
maxResults	integer	10	Max products to extract (1–100)
includeDetails	boolean	false	Visit each product page for seller, shipping, full condition & description. Leave false for fast, search-only data
proxyConfiguration	object	Residential	Apify Proxy settings. Residential in the target country is recommended (and applied automatically)

Input Example

{
  "country": "MX",
  "searchQuery": "iphone 15",
  "maxResults": 20,
  "includeDetails": true
}

proxyConfiguration is left out on purpose: the input form already prefills Apify Residential, and the actor pins the exit IP to the country you selected when no explicit geo is set. Mercado Libre answers an off-geo IP with a stripped page, so that pin is what keeps results coming.

📤 Output

Each product produces one object. currency always matches the selected country's marketplace. Fields marked (detail) are only populated when includeDetails=true.

Field	Type	Description
product_id	string	Mercado Libre product ID (prefix varies by country: MLB, MLM, MLA, MLC, MCO, MPE, MLU)
title	string	Product title
price	number	Current price in the marketplace currency
original_price	number	Original price before discount
discount_pct	integer	Discount percentage
currency	string	Marketplace currency (BRL, MXN, ARS, CLP, COP, PEN, UYU)
condition	string	"Novo", "Usado" or "unknown" — the Portuguese labels are used for every country
seller.nickname	string | null	Seller display name, or null when neither the card nor the page names one
seller.total_sales	integer	Units sold, read from the "N vendidos" line on the product page (detail — key absent when that line is missing)
shipping.free_shipping	boolean	true when the search card says free shipping. This is the only shipping field
categories	string[]	Up to 3 breadcrumb levels, closest to the product (detail — [] otherwise)
reviews_count	integer	Number of product reviews (0 when none was found)
average_rating	number	Average review rating (0 when none was found)
url	string	Product page URL
thumbnail	string | null	Product image URL
source	string	"html" (search card) or "html-link" (link fallback)
scrapedAt	string	ISO 8601 extraction timestamp

Not in the output: delivery estimate (estimated_days), shipping type (fulfillment / standard) and seller reputation level. None of them is read from the page — shipping carries the single boolean free_shipping.

Output Example

{
  "product_id": "MLM3576810718",
  "title": "iPhone 15 128 GB Negro",
  "price": 17999.00,
  "original_price": 19999.00,
  "discount_pct": 10,
  "currency": "MXN",
  "condition": "Novo",
  "seller": {
    "nickname": "APPLE STORE MX",
    "total_sales": 85000
  },
  "shipping": {
    "free_shipping": true
  },
  "categories": ["Celulares y Teléfonos", "Smartphones", "Apple"],
  "reviews_count": 1240,
  "average_rating": 4.7,
  "url": "https://www.mercadolibre.com.mx/p/MLM3576810718",
  "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_...",
  "source": "html",
  "scrapedAt": "2026-05-16T12:00:00.000Z"
}

💡 Use Cases

• Cross-Border Price Monitoring — Compare the same product's price across 7 LATAM markets
• Regional Market Research — Analyze demand, categories, and discounts per country
• Competitor & Seller Analysis — Track seller reputation and pricing by marketplace
• Affiliate & Dropshipping Sourcing — Find top products and sellers in each LATAM niche
• E-commerce Intelligence — Track how often free shipping shows up per region

✅ Capabilities & Limits

Stated up front, so you do not pay a run to find out.

Built here: Mercado Libre's geo-block is silent: an off-geo exit IP returns HTTP 200 with a stripped SERP, no captcha, no 403. Status codes miss it. Page weight catches it - under 100k chars of rendered HTML with zero new product cards retires the session and re-throws, so the next of 3 attempts draws a fresh IP.

Input / feature	Supported	Notes
Country marketplace	✅	country — BR, MX, AR, CL, CO, PE, UY (each has its own domain)
Search term	✅	searchQuery — required
Direct product URLs	❌	this actor searches; it does not take product URLs
Full product detail	⚠️	includeDetails visits each product page for seller, shipping and description — noticeably slower
Seller nickname	✅	seller.nickname; null when neither the card nor the page names a seller
Seller reputation level	❌	no reputation or medal field is parsed — seller carries nickname and, when the page shows it, total_sales
Delivery estimate (shipping.estimated_days)	❌	no delivery date or day count is read; shipping is a single boolean, free_shipping
Shipping type (fulfillment / standard)	❌	not parsed
Revenue	❌	Mercado Libre publishes no revenue figures
Result volume	⚠️	maxResults
Proxy	⚠️	residential recommended — datacenter IPs get throttled

❓ FAQ

Q: How do I scrape a country other than Brazil? A: Set country to MX, AR, CL, CO, PE, or UY. The Actor switches to that marketplace's domain, locale, and currency automatically.

Q: Do I need a Mercado Libre API key? A: No — the Actor works without any API credentials.

Q: What proxy should I use? A: Apify Residential proxy in the target country. Mercado Libre geo-blocks foreign IPs, so the Actor requests RESIDENTIAL with the country code automatically.

Q: What does includeDetails do? A: When true, the Actor visits each product page to add seller, shipping, full condition, categories, and reviews. When false (default), it returns faster search-only data.

Q: Am I charged if a run returns no products? A: No. Billing is per product-scraped; a run that returns zero products is not charged for results.

💰 Pricing

$0.012 per product scraped, Apify platform usage of the run is included — compute and proxy are not billed to you separately.

This actor uses Pay Per Event (PPE) pricing. The rate depends on your Apify plan tier:

Plan tier	Per product scraped	Per 1,000
Free	$0.012	$12.00
Bronze	$0.01	$10.00
Silver	$0.008	$8.00
Gold	$0.006	$6.00
Platinum	$0.004	$4.00
Diamond	$0.003	$3.00

You are never charged for a run that returned nothing. When the source blocks and nothing is extracted, the actor returns a labeled diagnostic and charges no PPE event.

🔗 Related Actors

• Mercado Livre BR Scraper — Brazil-only single-marketplace version
• Amazon Multi-Country Intelligence — Amazon across multiple marketplaces
• CNPJ Enricher — Enrich Brazilian sellers with company data
• Google Maps BR Scraper — Local business data + reviews

📝 Changelog

v1.1 (Current)

• LATAM expansion: 7 marketplaces (BR, MX, AR, CL, CO, PE, UY) with native domains, locales, and currencies
• Geo-aware Residential proxy per country
• includeDetails toggle for cost/speed control

v1.0

• Initial geo-fork of the Brazil Mercado Livre scraper

---

Mercado Libre Multi-País Scraper 🛒 7 Marketplaces da América Latina (BR, MX, AR, CL, CO, PE, UY)

🇺🇸 English | 🇧🇷 Português

Extraia listagens de produtos do Mercado Livre / Mercado Libre em 7 marketplaces da América Latina — Brasil, México, Argentina, Chile, Colômbia, Peru e Uruguai — com um único Actor. Escolha um country e o scraper usa o domínio, idioma e moeda nativos daquele país automaticamente. Extraia detalhes do produto, preços, dados do vendedor, frete, avaliações e categorias. Sem necessidade de API key.

✨ Funcionalidades

• 🌎 7 países LATAM em um Actor — BR, MX, AR, CL, CO, PE, UY, cada um no seu domínio nativo
• 💱 Moeda e idioma por país — Preços na moeda real do marketplace (BRL, MXN, ARS, CLP, COP, PEN, UYU)
• 🛒 Busca de produtos — Qualquer termo no marketplace do país escolhido
• 💰 Preços completos — Preço, preço original, desconto, moeda
• 🏪 Dados do vendedor — Apelido, mais unidades vendidas quando a página mostra a linha "N vendidos" (requer includeDetails)
• 🚚 Flag de frete grátis — Booleano, lido do card da busca
• ⭐ Avaliações e categorias — Nota, contagem e até 3 níveis de breadcrumb (requer includeDetails)
• ⚡ Controle de custo/velocidade — includeDetails=false (padrão) retorna dados rápidos da busca; ative para enriquecimento profundo por produto
• 🌐 Proxy geo-consciente — Usa proxy Residencial Apify no país-alvo (o Mercado Libre bloqueia IPs estrangeiros)

🌍 Países Suportados

Código	Marketplace	Domínio	Moeda
BR	Brasil	mercadolivre.com.br	BRL
MX	México	mercadolibre.com.mx	MXN
AR	Argentina	mercadolibre.com.ar	ARS
CL	Chile	mercadolibre.cl	CLP
CO	Colômbia	mercadolibre.com.co	COP
PE	Peru	mercadolibre.com.pe	PEN
UY	Uruguai	mercadolibre.com.uy	UYU

📥 Entrada

Parâmetro	Tipo	Padrão	Descrição
country	string	"BR"	Marketplace alvo: BR, MX, AR, CL, CO, PE, UY
searchQuery	string	(obrigatório)	Termo de busca (ex: "iphone 15", "notebook samsung")
maxResults	inteiro	10	Máx produtos a extrair (1–100)
includeDetails	boolean	false	Visita cada página de produto para vendedor, frete, condição e descrição completas. Deixe false para dados rápidos só da busca
proxyConfiguration	objeto	Residencial	Configuração de proxy Apify. Residencial no país-alvo é recomendado (e aplicado automaticamente)

Exemplo de Entrada

{
  "country": "MX",
  "searchQuery": "iphone 15",
  "maxResults": 20,
  "includeDetails": true
}

proxyConfiguration ficou de fora de propósito: o formulário já vem com o Residencial da Apify preenchido, e o actor fixa o IP de saída no country escolhido quando nenhuma geo explícita é informada. O Mercado Libre responde a um IP fora da geo com uma página vazia — essa fixação é o que mantém os resultados vindo.

📤 Saída

Cada produto produz um objeto. currency sempre corresponde ao marketplace do país escolhido. Campos marcados (detalhe) só são preenchidos quando includeDetails=true.

Campo	Tipo	Descrição
product_id	string	ID do produto (prefixo varia por país: MLB, MLM, MLA, MLC, MCO, MPE, MLU)
title	string	Título do produto
price	número	Preço atual na moeda do marketplace
original_price	número	Preço original antes do desconto
discount_pct	inteiro	Porcentagem de desconto
currency	string	Moeda do marketplace (BRL, MXN, ARS, CLP, COP, PEN, UYU)
condition	string	"Novo", "Usado" ou "unknown" — os rótulos em português valem para todos os países
seller.nickname	string | null	Nome do vendedor, ou null quando nem o card nem a página trazem um
seller.total_sales	inteiro	Unidades vendidas, lidas da linha "N vendidos" na página do produto (detalhe — a chave não existe quando a linha não aparece)
shipping.free_shipping	boolean	true quando o card da busca indica frete grátis. É o único campo de frete
categories	string[]	Até 3 níveis de breadcrumb, os mais próximos do produto (detalhe — [] fora disso)
reviews_count	inteiro	Número de avaliações (0 quando nada foi encontrado)
average_rating	número	Nota média (0 quando nada foi encontrado)
url	string	URL da página do produto
thumbnail	string | null	URL da imagem
source	string	"html" (card da busca) ou "html-link" (fallback por link)
scrapedAt	string	Timestamp ISO 8601 da extração

Não sai na saída: prazo de entrega (estimated_days), tipo de envio (fulfillment / standard) e nível de reputação do vendedor. Nada disso é lido da página — shipping tem apenas o booleano free_shipping.

💡 Casos de Uso

• Monitoramento de Preço Transfronteiriço — Compare o preço do mesmo produto em 7 mercados LATAM
• Pesquisa de Mercado Regional — Analise demanda, categorias e descontos por país
• Análise de Concorrência e Vendedores — Acompanhe reputação e preços por marketplace
• Sourcing para Afiliados e Dropshipping — Encontre produtos e vendedores top em cada nicho LATAM
• Inteligência de E-commerce — Acompanhe com que frequência o frete grátis aparece por região

❓ Perguntas Frequentes

P: Como extraio um país diferente do Brasil? R: Defina country como MX, AR, CL, CO, PE ou UY. O Actor muda para o domínio, idioma e moeda daquele marketplace automaticamente.

P: Preciso de API key do Mercado Libre? R: Não — o Actor funciona sem nenhuma credencial de API.

P: Qual proxy devo usar? R: Proxy Residencial Apify no país-alvo. O Mercado Libre bloqueia IPs estrangeiros, então o Actor solicita RESIDENTIAL com o código do país automaticamente.

P: O que faz o includeDetails? R: Quando true, o Actor visita cada página de produto para adicionar vendedor, frete, condição completa, categorias e avaliações. Quando false (padrão), retorna dados mais rápidos só da busca.

P: Sou cobrado se a execução não retornar produtos? R: Não. A cobrança é por product-scraped; execução com zero produtos não é cobrada por resultados.

💰 Preços

$0.012 por produto extraído, o uso de plataforma da Apify está incluído — compute e proxy não são cobrados à parte.

This actor uses Pay Per Event (PPE) pricing. The rate depends on your Apify plan tier:

Plan tier	Per product scraped	Per 1,000
Free	$0.012	$12.00
Bronze	$0.01	$10.00
Silver	$0.008	$8.00
Gold	$0.006	$6.00
Platinum	$0.004	$4.00
Diamond	$0.003	$3.00

You are never charged for a run that returned nothing. When the source blocks and nothing is extracted, the actor returns a labeled diagnostic and charges no PPE event.

🔗 Actors Relacionados

• Mercado Livre BR Scraper — Versão só Brasil (marketplace único)
• Amazon Multi-Country Intelligence — Amazon em múltiplos marketplaces
• CNPJ Enricher — Enriqueça vendedores brasileiros com dados empresariais
• Google Maps BR Scraper — Dados de empresas locais + avaliações

📝 Histórico de Versões

v1.1 (Atual)

• Expansão LATAM: 7 marketplaces (BR, MX, AR, CL, CO, PE, UY) com domínios, idiomas e moedas nativos
• Proxy Residencial geo-consciente por país
• Toggle includeDetails para controle de custo/velocidade

v1.0

• Geo-fork inicial do scraper Mercado Livre Brasil