Mercado Livre BR Scraper 🛒

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

Scrape product listings from Mercado Livre Brasil (mercadolivre.com.br). Extract product details, pricing, seller data, shipping info, reviews, and categories. No API key needed.

✨ Features

• 🛒 Product search — Search any product on Mercado Livre Brasil
• 💰 Full pricing — Price, original price, discount percentage, currency
• 🏪 Seller data — Nickname, plus total sales when includeDetails is on
• 🚚 Shipping — Free-shipping flag
• ⭐ Ratings — Average rating and review count (aggregate numbers, not review texts)
• 🏷️ Categories — Full category tree per product
• ✅ Validated output — Every item checked before delivery
• 🌐 Apify Proxy — Built-in proxy support

📥 Input

Parameter	Type	Default	Description
searchQuery	string	"notebook samsung"	Search term on Mercado Livre
maxResults	integer	10	Max products to extract (1–100)
includeDetails	boolean	false	Visit each product page (Phase 2) to enrich seller, condition, categories and rating. Off by default: Phase 2 is ~70% of the run cost.

Input Example

{
  "searchQuery": "iphone 15",
  "maxResults": 5,
  "includeDetails": false
}

📤 Output

Each product produces one object:

Field	Type	Description
product_id	string	Mercado Livre product ID (MLB...)
title	string	Product title
price	number	Current price in BRL (0 when the card exposes no parsable price)
original_price	number | null	Strikethrough price before discount
discount_pct	integer | null	Discount percentage
currency	string	Always "BRL"
condition	string	"Novo", "Usado" or "unknown"
seller.nickname	string | null	Seller display name
seller.total_sales	integer	Units sold, parsed from the "N vendidos" counter. Only with includeDetails: true, and only when the product page shows it
shipping.free_shipping	boolean	Whether the listing advertises free shipping
categories	string[]	Breadcrumb category tree. Always [] when includeDetails: false
reviews_count	integer	Number of ratings (0 when unavailable)
average_rating	number	Average rating, 1.0–5.0 (0 when unavailable)
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

Output Example

Run with includeDetails: true. With includeDetails: false the same keys are present, but categories is [] and seller carries only nickname.

{
  "product_id": "MLB3576810718",
  "title": "Notebook Samsung Galaxy Book3 ...",
  "price": 2899,
  "original_price": 3499,
  "discount_pct": 17,
  "currency": "BRL",
  "condition": "Novo",
  "seller": {
    "nickname": "SAMSUNG OFICIAL",
    "total_sales": 150000
  },
  "shipping": {
    "free_shipping": true
  },
  "categories": ["Informática", "Notebooks", "Samsung"],
  "reviews_count": 1823,
  "average_rating": 4.6,
  "url": "https://www.mercadolivre.com.br/notebook-samsung.../p/MLB3576810718",
  "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_...",
  "source": "html",
  "scrapedAt": "2026-08-27T12:00:00.000Z"
}

💰 Cost

Approximately $0.012 per product (Pay Per Event) — see the Pricing section below for examples.

📋 Use Cases

• Price Monitoring — Track product prices and discounts over time
• Competitor Analysis — Compare seller sales volume and pricing
• Market Research — Analyze product categories and demand
• Lead Generation — Find top sellers in your niche
• E-commerce Intelligence — Monitor shipping options and fulfillment

✅ Capabilities & Limits

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

Built here: an off-geo exit IP makes Mercado Livre answer HTTP 200 with no captcha and zero product cards. That is caught by HTML size - under 100k chars with 0 cards retires the proxy session and retries on a fresh Brazilian IP. A real SERP is around 2 MB, so genuine selector drift still fails loudly.

Input / feature	Supported	Notes
searchQuery — required	✅	Termo de busca no Mercado Livre (ex: 'notebook samsung', 'iphone 15')
Result volume (maxResults)	⚠️	Número máximo de produtos a extrair (padrão: 10)
includeDetails	✅	Visitar página de cada produto para extrair seller, condição completa, frete detalhado, descrição. DESLIGAR reduz custo ~70% (skip Phase 2 Playwright…

❓ FAQ

Q: Do I need a Mercado Livre API key? A: No! This actor works without any API credentials.

Q: What proxy should I use? A: Apify Proxy with residential proxies (Brazil) is recommended.

Q: Can I search for any product? A: Yes! Any search term that works on mercadolivre.com.br works here.

Q: Does it extract seller data? A: It returns seller.nickname, plus seller.total_sales when includeDetails: true and the product page exposes a "N vendidos" counter. A reputation level (green/red medal) is not extracted.

Q: How many products can I extract per run? A: Up to 100 products per search query.

💰 Pricing

This actor uses Pay Per Event (PPE) pricing:

Metric	Cost
product-scraped	$0.012 per product

Examples: 50 products = $0.60 · 100 products = $1.20 · 1,000 products = $12.00.

🔗 Related Actors

• CNPJ Enricher — Enrich sellers with company data
• Google Maps BR — Business data + reviews
• Instagram Reels Scraper — Social media metrics

📝 Changelog

v1.3 (Current)

• ✅ Improved reliability and error handling
• ✅ Enhanced seller data extraction
• ✅ Better review and category extraction

v1.0

• Initial release

---

Mercado Livre BR Scraper 🛒

🇺🇸 English | 🇧🇷 Português

Raspe listagens de produtos do Mercado Livre Brasil (mercadolivre.com.br). Extraia detalhes do produto, preços, dados do vendedor, frete, avaliações e categorias. Sem necessidade de API key.

✨ Funcionalidades

• 🛒 Busca de produtos — Pesquise qualquer produto no Mercado Livre Brasil
• 💰 Preços completos — Preço, preço original, desconto, moeda
• 🏪 Dados do vendedor — Apelido e, com includeDetails ligado, total de vendas
• 🚚 Frete — Indicador de frete grátis
• ⭐ Avaliações — Nota média e contagem de avaliações (números agregados, não os textos das avaliações)
• 🏷️ Categorias — Árvore de categorias por produto
• ✅ Output validado — Cada item verificado antes da entrega
• 🌐 Apify Proxy — Suporte a proxy integrado

📥 Entrada

Parâmetro	Tipo	Padrão	Descrição
searchQuery	string	"notebook samsung"	Termo de busca no Mercado Livre
maxResults	inteiro	10	Máx produtos a extrair (1–100)
includeDetails	boolean	false	Visitar a página de cada produto (Fase 2) para enriquecer vendedor, condição, categorias e nota. Desligado por padrão: a Fase 2 é ~70% do custo da execução.

Exemplo de Entrada

{
  "searchQuery": "iphone 15",
  "maxResults": 5,
  "includeDetails": false
}

📤 Saída

Cada produto produz um objeto:

Campo	Tipo	Descrição
product_id	string	ID do produto (MLB...)
title	string	Título do produto
price	número	Preço atual em BRL (0 quando o card não expõe preço legível)
original_price	número | null	Preço riscado, antes do desconto
discount_pct	inteiro | null	Porcentagem de desconto
currency	string	Sempre "BRL"
condition	string	"Novo", "Usado" ou "unknown"
seller.nickname	string | null	Nome do vendedor
seller.total_sales	inteiro	Unidades vendidas, extraídas do contador "N vendidos". Só com includeDetails: true, e só quando a página do produto exibe o contador
shipping.free_shipping	boolean	Se o anúncio informa frete grátis
categories	string[]	Árvore de categorias (breadcrumb). Sempre [] quando includeDetails: false
reviews_count	inteiro	Número de avaliações (0 quando indisponível)
average_rating	número	Nota média, 1.0–5.0 (0 quando indisponível)
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

Exemplo de Saída

Execução com includeDetails: true. Com includeDetails: false as mesmas chaves existem, mas categories vem [] e seller traz apenas nickname.

{
  "product_id": "MLB3576810718",
  "title": "Notebook Samsung Galaxy Book3 ...",
  "price": 2899,
  "original_price": 3499,
  "discount_pct": 17,
  "currency": "BRL",
  "condition": "Novo",
  "seller": {
    "nickname": "SAMSUNG OFICIAL",
    "total_sales": 150000
  },
  "shipping": {
    "free_shipping": true
  },
  "categories": ["Informática", "Notebooks", "Samsung"],
  "reviews_count": 1823,
  "average_rating": 4.6,
  "url": "https://www.mercadolivre.com.br/notebook-samsung.../p/MLB3576810718",
  "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_...",
  "source": "html",
  "scrapedAt": "2026-08-27T12:00:00.000Z"
}

💰 Custo

Aproximadamente $0.012 por produto (Pay Per Event) — veja a seção Preços abaixo para exemplos.

📋 Casos de Uso

• Monitoramento de preços — Acompanhe preços e descontos ao longo do tempo
• Análise da concorrência — Compare volume de vendas e preços dos vendedores
• Pesquisa de mercado — Analise categorias e demanda de produtos
• Geração de leads — Encontre os melhores vendedores no seu nicho
• Inteligência de e-commerce — Monitore opções de frete e fulfillment

❓ Perguntas Frequentes

P: Preciso de API key do Mercado Livre? R: Não! Este actor funciona sem nenhuma credencial de API.

P: Qual proxy devo usar? R: Apify Proxy com proxies residenciais (Brasil) é recomendado.

P: Posso buscar qualquer produto? R: Sim! Qualquer termo que funcione no mercadolivre.com.br funciona aqui.

P: Extrai dados do vendedor? R: Retorna seller.nickname e, com includeDetails: true, também seller.total_sales quando a página do produto exibe o contador "N vendidos". O nível de reputação (medalha verde/vermelha) não é extraído.

P: Quantos produtos posso extrair por execução? R: Até 100 produtos por busca.

💰 Preços

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

Métrica	Custo
product-scraped	$0.012 por produto

Exemplos: 50 produtos = $0.60 · 100 produtos = $1.20 · 1.000 produtos = $12.00.

🔗 Actors Relacionados

• CNPJ Enricher — Enriqueça vendedores com dados empresariais
• Google Maps BR — Dados de empresas + avaliações
• Instagram Reels Scraper — Métricas de redes sociais

---

💡 Need AI analysis on top of this data — sentiment, trend detection and a dashboard, with no API keys to manage? ViralAnalyzer runs this actor + 42 more data sources with built-in AI. JSON + insights in one call.