Mercado Livre Scraper (Português)

Mercado Livre Scraper (Português)

Extraia dados valiosos do Mercado Livre — o maior marketplace de e-commerce da América Latina — sem escrever código: páginas de produto, avaliações de compradores, perguntas e respostas, e perfis de loja, nos 9 países onde o Mercado Livre opera.

Obtenha a ficha técnica completa de um produto, suas perguntas e respostas, e suas melhores avaliações em uma única chamada; percorra todas as avaliações de um produto em 9 marketplaces com uma varredura profunda por classificação e ordem; ou extraia o perfil de uma loja — seguidores, marca e menu de categorias incluídos.

Copiar para seu assistente de IA

Copie este bloco no ChatGPT, Claude, Cursor ou qualquer LLM para começar a usar este Actor.

Use o Actor da Apify "parsebird/mercadolibre-scraper-portugues" (chame-o via ApifyClient: client.actor("parsebird/mercadolibre-scraper-portugues").call(run_input={...})). Ele tem três modos selecionáveis pelo campo de entrada "mode": "reviews" (padrão) retorna avaliações paginadas de compradores para uma ou mais "productUrls" nos 9 sites do Mercado Livre na América Latina, usando uma estratégia de varredura profunda por classificação e ordem para recuperar até ~950 avaliações por produto; "product" retorna todos os campos da página do produto para "productUrls" — título, marca, preço, parcelas, moeda, disponibilidade, condição, SKU, classificação, vendedor (id/nome/reputação/nível/loja oficial), até 50+ atributos, categorias, variações, até 20 perguntas e respostas de compradores, e as 5 melhores avaliações; "seller" retorna uma linha de perfil de loja para cada "sellerUrls" (deve ser uma URL /loja/, /tienda/ ou /pagina/) com seguidores, informações de marca, banner, menu de categorias e sinais de conformidade. Outros campos importantes: "country" (BR/MX/AR/EC/DO/CL/CO/PE/UY, padrão BR), "maxItems" (padrão 50), "reviewRating" (padrão "all"), "reviewOrder" (padrão "relevance"), "includeReviews"/"includeQuestions"/"includeVariations" (modo product, padrão true). A saída é enviada ao dataset padrão — uma linha por avaliação/produto/vendedor, com nomes de campo em inglês (title, price, sellerName, etc.). Esquema completo de entrada/saída e exemplos: https://apify.com/parsebird/mercadolibre-scraper-portugues/input-schema e https://apify.com/parsebird/mercadolibre-scraper-portugues/api. Obtenha seu token de API em https://console.apify.com/settings/integrations.

O que o Mercado Livre Scraper (Português) faz?

Mercado Livre Scraper (Português) é uma ferramenta de extração de dados do Mercado Livre com três modos em um só Actor:

• 🛒 Modo produto — todos os dados da ficha de produto: título, marca, preço, preço anterior e % de desconto, parcelas, moeda, disponibilidade, condição, SKU, classificação e número de avaliações, identidade e reputação do vendedor, selo de loja oficial, 50+ atributos do produto, categorias (breadcrumbs), variações de cor/tamanho/capacidade, até 20 perguntas de compradores com suas respostas, e as 5 melhores avaliações.
• ⭐ Modo avaliações — todas as avaliações paginadas de um ou mais produtos. Quando o filtro de classificação fica em "all", o Actor executa uma varredura profunda — 12 consultas simultâneas combinando cada classificação em estrelas e as duas ordens — para recuperar muito mais avaliações únicas do que uma única consulta permite (o Mercado Livre limita uma única consulta a um offset de ~300 / ~330 avaliações; a varredura profunda pode recuperar até ~950 em um produto popular).
• 🏪 Modo vendedor — uma linha de perfil de loja por vendedor: número de seguidores, data de criação, tags, banner e logo, datas de teste grátis, informações de marca registrada, status de loja oficial e o menu completo de categorias (corridors).
• 🌎 Os 9 marketplaces da América Latina — Brasil, México, Argentina, Chile, Colômbia, Peru, Uruguai, Equador e República Dominicana, com um único parâmetro country.
• ⚡ Roda na plataforma da Apify: agende execuções recorrentes, acione via API ou webhook, e exporte resultados em JSON, CSV ou Excel.

A extração de perguntas e respostas e a estratégia de varredura profunda de avaliações cobrem casos de uso que a maioria dos scrapers do Mercado Livre não resolve bem: recuperar a conversa completa comprador-vendedor e maximizar a cobertura de avaliações em produtos populares.

Quais dados este scraper extrai do Mercado Livre?

Campo	Descrição
title, brand, sku	Identidade do produto
price, originalPrice, discountPercentage, currency	Preço e desconto
installments	Plano de parcelas sem juros (quantidade, valor por parcela, total)
availability, condition	Status de estoque e condição do item
rating, ratingCount, reviewCount	Dados agregados de classificação
sellerId, sellerName, sellerReputation, sellerPowerStatus, isOfficialStore	Identidade e reputação do vendedor
attributes	Especificações do produto (RAM, dimensões, cor, modelo e 50+ mais, conforme a categoria)
variations	Opções de cor/tamanho/capacidade, quando o anúncio as possui
questions	Perguntas de compradores com respostas do vendedor (até 20 por produto)
reviews	As 5 melhores avaliações (modo produto) ou texto, classificação, data, curtidas e mídia de todas as avaliações paginadas (modo avaliações)
totalFollowers, bannerUrl, menuCorridors, freeTrialStart/End	Perfil de loja do vendedor (modo vendedor)

Os nomes dos campos de saída ficam em inglês (assim são consumidos pela maioria das ferramentas de BI e planilhas), embora toda a interface — título, descrições e opções de entrada — esteja em português. Veja a aba Output para a lista completa de campos por modo.

Como extrair dados do Mercado Livre com este Actor

1. Abra a aba Input do Actor no Apify Console, ou use a API.
2. Escolha um Modo: reviews para avaliações de compradores, product para todos os dados da ficha de produto, ou seller para o perfil de uma loja.
3. Cole uma ou mais URLs do Mercado Livre em URLs de produto (modo reviews/product) ou URLs de vendedor (modo seller). Também é possível colá-las em URLs de início — o modo e o país são detectados automaticamente.
4. Escolha o País correspondente ao marketplace, defina o Máximo de itens e clique em Start.
5. Baixe os resultados em JSON, CSV ou Excel na aba Dataset, ou consuma-os via API / Integrações (Zapier, Make, Google Sheets e mais).

Exemplo de saída

Modo avaliações, uma linha por avaliação:

{
  "mode": "reviews",
  "country": "BR",
  "productId": "MLB1027172669",
  "catalogProductId": "MLB1027172678",
  "reviewId": 1009454165,
  "reviewRating": 5,
  "reviewText": "Simplesmente sensacional!!! meu primeiro iphone, decidi sair do android e estou amando!!! celular original, funcionando perfeitamente! sem contar a cor que é linda!!! e valor bem em conta por ser o iphone 15! custo benefício ótimo e chega no dia seguinte! comprem sem medo.",
  "reviewDate": "2024-02-18T22:53:21Z",
  "reviewDateText": "Há mais de 1 ano",
  "reviewCountry": "Brasil",
  "reviewLikes": 2165,
  "reviewMedia": ["https://http2.mlstatic.com/D_NQ_NP_761439-MLA74589090173_022024-F.jpg"],
  "scrapedAt": "2026-08-16T09:17:40.674Z"
}

Modo vendedor, linha de perfil de loja:

{
  "mode": "seller",
  "kind": "profile",
  "country": "BR",
  "sellerSlug": "samsung",
  "sellerProfileUrl": "https://www.mercadolivre.com.br/loja/samsung",
  "shopName": "samsung",
  "shopType": "brand",
  "isOfficialStore": true,
  "totalFollowers": 440741,
  "dateCreated": "2023-12-27T17:35:12Z",
  "status": "active",
  "tags": ["priority_brand", "normal_store", "has_followers", "brand_store"],
  "brandName": "Samsung",
  "brandRegistryId": "49063",
  "bannerUrl": "https://http2.mlstatic.com/D_NQ_NP_643886-MLA92800028365_092025-F.jpg",
  "scrapedAt": "2026-08-16T09:20:00.000Z"
}

Casos de uso

• Monitoramento de preço e estoque — acompanhe o preço, desconto, parcelas e disponibilidade de um produto ao longo do tempo.
• Mineração de avaliações — recupere todas as avaliações de um produto nos 9 marketplaces para análise de sentimento ou dashboards de feedback.
• Pesquisa competitiva de perguntas e respostas — veja o que os compradores perguntam e quão bem (e rápido) os vendedores respondem.
• Due diligence de vendedores — verifique o nível de reputação, status de loja oficial, crescimento de seguidores e sinais de conformidade de uma loja antes de se associar ou comparar concorrentes.
• Pesquisa de categorias — reúna especificações e atributos de um catálogo de produtos para uma tabela comparativa ou feed.

Como funciona

1. O modo avaliações chama diretamente a API interna de avaliações do Mercado Livre (noindex/catalog/reviews/...) — sem navegador nem proxy, por isso é rápido e barato. Com o filtro de classificação em "all", o Actor dispara 12 solicitações simultâneas (5 classificações em estrelas + "all", × 2 ordens) e remove duplicatas por ID de avaliação para maximizar as avaliações únicas recuperadas.
2. O modo vendedor obtém a página /loja/ ou /tienda/ de forma anônima e extrai os campos do perfil a partir do estado da página incorporado — também não precisa de proxy.
3. O modo produto renderiza a página com uma sessão de navegador real, com impressão digital (fingerprint) realista, através do proxy residencial da Apify (roteado para o país selecionado), porque as páginas de produto do Mercado Livre estão protegidas por um desafio anti-bot executado em JavaScript que solicitações HTTP simples não conseguem superar. O Actor extrai o mesmo estado de página em JSON usado pelo frontend do Mercado Livre, além do JSON-LD Product (schema.org) da página, e então visita a página dedicada de perguntas e respostas do anúncio para obter a lista completa.
4. Cada modo envia linhas normalizadas diretamente ao dataset da Apify, prontas para exportar ou consumir via API.

Parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
mode	string	Não	reviews	reviews, product ou seller
country	string	Não	BR	Marketplace do Mercado Livre (BR, MX, AR, EC, DO, CL, CO, PE, UY)
productUrls	array	Para reviews/product	—	URLs de produto do Mercado Livre (catálogo /p/MLB… ou anúncio MLB-…)
maxItems	integer	Não	50	Máximo de itens a retornar (modo reviews: por produto)
reviewRating	string	Não	all	Filtra o modo reviews por classificação em estrelas, ou all para a varredura profunda
reviewOrder	string	Não	relevance	relevance ou dateCreated
sellerUrls	array	Para modo seller	—	URLs de loja (/loja/, /tienda/ ou /pagina/)
includeReviews	boolean	Não	true	Modo product: inclui as 5 melhores avaliações
includeQuestions	boolean	Não	true	Modo product: inclui perguntas e respostas
includeVariations	boolean	Não	true	Modo product: inclui variações
startUrls	array	Não	—	URLs diretas; modo e país detectados automaticamente
maxConcurrency	integer	Não	8	Solicitações em paralelo na varredura profunda do modo reviews
useResidentialProxy	boolean	Não	true	Informativo para o modo product, que sempre usa proxy residencial

Veja a aba Input para descrições completas e valores possíveis.

Quanto custa extrair dados do Mercado Livre?

Este Actor usa o modelo de preço por evento (pay-per-event) — você paga apenas pelos registros efetivamente enviados ao dataset, não pelo tempo de processamento.

Plano	Preço por evento	Preço por 1.000
Gratuito	$0.0025	$2,50
Bronze	$0.0017	$1,70
Silver	$0.0012	$1,20
Gold	$0.0010	$1,00

Cada linha enviada — uma avaliação, um produto ou um perfil de vendedor — conta como um evento result-scraped. Os planos pagos da Apify (Bronze, Silver, Gold) recebem automaticamente uma tarifa por evento menor. Uma execução que recupera 300 avaliações de um produto custa cerca de $0,75 no plano gratuito (até $0,30 no Gold); uma única ficha de produto custa $0,0025. O teste grátis da Apify é suficiente para testar os três modos antes de escolher um plano. O modo produto também consome banda do proxy residencial da Apify (~$8/GB, cobrado separadamente pela Apify), já que exige uma sessão de navegador real para superar o controle anti-bot do Mercado Livre.

É legal extrair dados do Mercado Livre?

Extrair dados públicos, como fichas de produto e avaliações do Mercado Livre, é geralmente legal — veja o artigo da Apify sobre a legalidade do web scraping para mais detalhes. Este Actor extrai apenas dados de páginas visíveis publicamente; não contorna login, paywalls nem acessa informações não públicas. Você é responsável por como usa os dados coletados e por cumprir os Termos e Condições do Mercado Livre.

Outros scrapers da ParseBird

• eBay Sold Listings Scraper — preços e histórico de anúncios vendidos no eBay
• 1688 Wholesale Scraper — dados de produtos por atacado do 1688.com
• Shopify Products Scraper — catálogos de produtos de qualquer loja Shopify
• MercadoLibre Scraper (English) — a mesma ferramenta, com interface em inglês
• MercadoLibre Scraper (Español) — a mesma ferramenta, com interface em espanhol

Perguntas frequentes

Por que não existe um modo de busca ou de listagem por categoria? As páginas de busca e listagem de categorias do Mercado Livre (listado.*/lista.*) estão protegidas por uma camada anti-bot mais rígida, aparentemente baseada em comportamento, do que as páginas de produto, e ainda não existe uma forma confiável de superá-la. Os modos produto, avaliações e perfil de vendedor funcionam corretamente e usam extração verificada contra dados reais do Mercado Livre.

Por que o modo vendedor retorna apenas uma linha por loja, e não o catálogo completo? Pelo mesmo motivo — o catálogo de itens de um vendedor é servido em páginas listado.*/lista.*, que este Actor não extrai de forma confiável por enquanto. O modo vendedor retorna os dados do perfil da loja (seguidores, marca, menu de categorias, sinais de conformidade), que vêm da página /loja/ ou /tienda/ e não são afetados por esse bloqueio.

O modo avaliações realmente cobre os 9 marketplaces? Sim — informe o country correspondente entre BR, MX, AR, CL, CO, PE, UY, EC ou DO, e o Actor monta a URL da API de avaliações para o domínio e site daquele país.

Por que o modo vendedor não está disponível na Argentina? As páginas de loja da Argentina (mercadolibre.com.ar/tienda/...) usam um framework de renderização diferente dos outros 8 sites, então o analisador de perfil de loja ainda não se aplica lá.

Posso agendar este Actor ou acioná-lo via API? Sim — use o Scheduler da Apify para execuções recorrentes, ou chame o Actor via API usando Python, JavaScript ou qualquer cliente HTTP. Exemplos de código abaixo.

Os nomes dos campos de saída estão em português? Não — os nomes dos campos (title, price, sellerName, etc.) permanecem em inglês para que o dataset seja compatível com ferramentas de BI, planilhas e integrações padrão. Toda a interface do Actor (título, descrições, opções de entrada e este README) está em português.

Algo não está funcionando, ou você quer sugerir uma nova funcionalidade? Abra um issue na aba Issues do Actor no Apify Console — relatos e sugestões são bem-vindos.

Exemplos de uso por API

Python (apify-client):

from apify_client import ApifyClient

client = ApifyClient("<SEU_TOKEN_DE_API>")
run = client.actor("parsebird/mercadolibre-scraper-portugues").call(run_input={
    "mode": "reviews",
    "country": "BR",
    "productUrls": ["https://www.mercadolivre.com.br/apple-iphone-15-256-gb-preto-distribuidor-autorizado/p/MLB1027172669"],
    "maxItems": 100,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["reviewText"])

JavaScript (apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<SEU_TOKEN_DE_API>' });
const run = await client.actor('parsebird/mercadolibre-scraper-portugues').call({
    mode: 'product',
    country: 'BR',
    productUrls: ['https://www.mercadolivre.com.br/apple-iphone-15-256-gb-preto-distribuidor-autorizado/p/MLB1027172669'],
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0].title, items[0].price);

Legal e conformidade

Este Actor extrai dados de páginas públicas do Mercado Livre para fins de pesquisa, monitoramento e análise. Ele não acessa contas privadas, não contorna autenticação e não armazena informações pessoais de compradores além do que o Mercado Livre exibe publicamente (por exemplo, o país de quem deixa uma avaliação, ou os dados públicos da loja de um vendedor). O uso deste Actor e dos dados coletados é de sua responsabilidade — revise os Termos e Condições do Mercado Livre antes de um uso comercial ou em grande escala.