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, reputation level, total sales (requires includeDetails)
• 🚚 Shipping info — Free shipping, estimated days, fulfillment type (requires includeDetails)
• ⭐ Reviews & categories — Rating, review count, full category tree (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": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

📤 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	new / used / refurbished / unknown
seller.nickname	string	Seller display name (detail)
seller.reputation	string	Seller reputation level (detail)
seller.total_sales	integer	Seller total sales count (detail)
shipping.free_shipping	boolean	Whether shipping is free (detail)
shipping.estimated_days	integer	Estimated delivery days (detail)
shipping.type	string	fulfillment / free / standard (detail)
categories	string[]	Product category tree (detail)
reviews_count	integer	Number of product reviews (detail)
average_rating	number	Average review rating 1.0–5.0 (detail)
url	string	Product page URL
thumbnail	string	Product image URL

Output Example

{
  "product_id": "MLM3576810718",
  "title": "iPhone 15 128 GB Negro",
  "price": 17999.00,
  "original_price": 19999.00,
  "discount_pct": 10,
  "currency": "MXN",
  "condition": "new",
  "seller": {
    "nickname": "APPLE STORE MX",
    "reputation": "5_green",
    "total_sales": 85000
  },
  "shipping": {
    "free_shipping": true,
    "estimated_days": 3,
    "type": "fulfillment"
  },
  "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_..."
}

💡 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 — Monitor shipping options and fulfillment per region

❓ 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

This actor uses Pay Per Event (PPE) pricing:

Metric	Cost
product-scraped	$0.035 per product

Example: Extracting 100 products costs $3.50. Billed per product regardless of country.

🔗 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, reputação, total de vendas (requer includeDetails)
• 🚚 Info de frete — Frete grátis, prazo, tipo de envio (requer includeDetails)
• ⭐ Avaliações e categorias — Nota, contagem, árvore de categorias (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": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

📤 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	new / used / refurbished / unknown
seller.nickname	string	Nome do vendedor (detalhe)
seller.reputation	string	Nível de reputação (detalhe)
seller.total_sales	inteiro	Total de vendas (detalhe)
shipping.free_shipping	boolean	Se o frete é grátis (detalhe)
shipping.estimated_days	inteiro	Prazo estimado em dias (detalhe)
shipping.type	string	fulfillment / free / standard (detalhe)
categories	string[]	Árvore de categorias (detalhe)
reviews_count	inteiro	Número de avaliações (detalhe)
average_rating	número	Nota média 1.0–5.0 (detalhe)
url	string	URL da página do produto
thumbnail	string	URL da imagem

💡 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 — Monitore opções de frete e fulfillment 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

Este actor usa precificação Pay Per Event (PPE):

Métrica	Custo
product-scraped	$0.035 por produto

Exemplo: Extrair 100 produtos custa $3.50. Cobrado por produto, independente do country.

🔗 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