# Mercado Livre Scraper (Português) (`parsebird/mercadolibre-scraper-portugues`) Actor

Extraia páginas de produto, avaliações de compradores, perguntas e respostas, e lojas do Mercado Livre em 9 países da América Latina, tudo em um só Actor.

- **URL**: https://apify.com/parsebird/mercadolibre-scraper-portugues.md
- **Developed by:** [ParseBird](https://apify.com/parsebird) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 resultados

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### 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.

<table><tr>
<td style="border-left:4px solid #1C1917;padding:12px 16px;font-weight:600">
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.
</td>
</tr></table>

##### 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](https://apify.com): 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](https://apify.com/parsebird/mercadolibre-scraper-portugues/output-schema) para a lista completa de campos por modo.

### Como extrair dados do Mercado Livre com este Actor

1. Abra a aba [Input](https://apify.com/parsebird/mercadolibre-scraper-portugues/input-schema) 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](https://apify.com/parsebird/mercadolibre-scraper-portugues/api) / [Integrações](https://docs.apify.com/platform/integrations) (Zapier, Make, Google Sheets e mais).

### Exemplo de saída

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

```json
{
  "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:

```json
{
  "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](https://apify.com/parsebird/mercadolibre-scraper-portugues/input-schema) 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)](https://docs.apify.com/platform/actors/publishing/monetize#pay-per-event-pricing-model) — 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](https://apify.com/pricing) 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](https://blog.apify.com/is-web-scraping-legal/) 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](https://www.mercadolivre.com.br/ajuda/termos-e-condicoes-gerais_1926).

### Outros scrapers da ParseBird

- [eBay Sold Listings Scraper](https://apify.com/parsebird/ebay-sold-listings-scraper) — preços e histórico de anúncios vendidos no eBay
- [1688 Wholesale Scraper](https://apify.com/parsebird/1688-wholesale-scraper) — dados de produtos por atacado do 1688.com
- [Shopify Products Scraper](https://apify.com/parsebird/shopify-products-scraper) — catálogos de produtos de qualquer loja Shopify
- [MercadoLibre Scraper (English)](https://apify.com/parsebird/mercadolibre-scraper) — a mesma ferramenta, com interface em inglês
- [MercadoLibre Scraper (Español)](https://apify.com/parsebird/mercadolibre-scraper-espanol) — 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](https://docs.apify.com/platform/schedules) da Apify para execuções recorrentes, ou chame o Actor via [API](https://apify.com/parsebird/mercadolibre-scraper-portugues/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](https://docs.apify.com/api/client/python/)):

```python
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](https://docs.apify.com/api/client/js/)):

```javascript
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](https://www.mercadolivre.com.br/ajuda/termos-e-condicoes-gerais_1926) antes de um uso comercial ou em grande escala.

# Actor input Schema

## `mode` (type: `string`):

O que extrair. 'reviews' retorna avaliações paginadas de um produto nos 9 marketplaces da América Latina. 'product' retorna todos os campos da página do produto (título, preço, marca, atributos, variações, vendedor, avaliações em destaque, perguntas e respostas). 'seller' retorna o perfil da loja de um vendedor.

## `country` (type: `string`):

Marketplace do Mercado Livre por país. Os nove sites da América Latina são compatíveis com todos os modos (reviews, product, seller). O país selecionado direciona o proxy residencial para IPs do mesmo país no modo 'product' e define o domínio correto para as URLs geradas. Execuções que não encontram resultados para um país não são cobradas por resultado.

## `productUrls` (type: `array`):

Uma ou mais URLs de produto do Mercado Livre. Usadas nos modos 'reviews' e 'product'. Aceita tanto URLs de catálogo (.../p/MLB…) quanto de anúncio (produto.\*/MLB-…). O exemplo pré-preenchido é a página de um iPhone no MLB.

## `maxItems` (type: `integer`):

Quantidade máxima de itens a retornar. 0 = sem limite. Product: páginas de produto; Reviews: avaliações POR PRODUTO, então 3 URLs de produto com 50 retornam até 150 linhas (o teto prático para um produto muito popular é ~900, porque o Mercado Livre limita a paginação de um único bucket a um offset de 300). Não é usado no modo 'seller' (sempre uma linha de perfil por URL de vendedor).

## `reviewRating` (type: `string`):

No modo 'reviews', extrai apenas avaliações com esta classificação em estrelas. O padrão 'all' ativa a estratégia de varredura profunda — 12 consultas simultâneas combinando classificação e ordenação — para recuperar o máximo de avaliações únicas por produto (até ~950 em produtos populares, contra ~330 com um único bucket).

## `reviewOrder` (type: `string`):

Ordem das avaliações. 'relevance' é a ordem padrão do Mercado Livre por utilidade; 'dateCreated' retorna as mais recentes primeiro. Isso se aplica quando 'Filtro de avaliação' tem uma classificação específica (1-5). Quando o filtro é 'all', a varredura profunda já combina as duas ordens em paralelo, então retorna o mesmo conjunto completo de resultados e esta opção não muda a quantidade obtida.

## `sellerUrls` (type: `array`):

Uma ou mais URLs de loja de vendedor: lojas de marca (https://www.mercadolivre.com.br/loja/samsung) ou lojas de outros países (.../tienda/... no México, .../pagina/... em e-shops independentes). Cada vendedor gera uma linha de perfil com seguidores, datas, banner, informações de marca e menu de categorias. Não suportado na Argentina (framework de loja diferente).

## `includeReviews` (type: `boolean`):

No modo 'product', inclui as 5 melhores avaliações a partir do JSON-LD da página. Avaliações completas e paginadas exigem o modo 'reviews'.

## `includeQuestions` (type: `boolean`):

No modo 'product', inclui perguntas de compradores e respostas do vendedor (até 20 por produto) a partir da página dedicada de perguntas do anúncio.

## `includeVariations` (type: `boolean`):

No modo 'product', inclui as variações do produto (cor/tamanho/capacidade) quando o anúncio as possui.

## `startUrls` (type: `array`):

URLs diretas para extrair. Aceita URLs de produto (tanto .../p/MLB… quanto produto.\*/MLB-…) ou URLs de loja de vendedor (.../loja/..., .../tienda/..., .../pagina/...). Colar URLs completas é suportado — país e modo são detectados automaticamente. Alternativa aos campos de URL específicos de cada modo.

## `maxConcurrency` (type: `integer`):

Máximo de solicitações em paralelo entre todas as combinações (produto × classificação × ordem) no modo 'reviews'. 8 é um valor seguro por padrão; aumente para lotes grandes (50+ produtos) se notar que o desempenho está travando. Limitado a 24 para evitar os limites de taxa do Mercado Livre.

## `useResidentialProxy` (type: `boolean`):

Os modos 'reviews' e 'seller' funcionam sem proxy residencial. O modo 'product' sempre usa o pool residencial da Apify (de acordo com o país selecionado) por meio de um navegador real — esta opção é apenas informativa para o modo 'product'. O tráfego residencial soma a taxa de uso da Apify de ~$8/GB, além do custo do Actor.

## Actor input object example

```json
{
  "mode": "reviews",
  "country": "BR",
  "productUrls": [
    "https://www.mercadolivre.com.br/apple-iphone-15-256-gb-preto-distribuidor-autorizado/p/MLB1027172669"
  ],
  "maxItems": 10,
  "reviewRating": "all",
  "reviewOrder": "relevance",
  "sellerUrls": [
    "https://www.mercadolivre.com.br/loja/samsung"
  ],
  "includeReviews": true,
  "includeQuestions": true,
  "includeVariations": true,
  "startUrls": [],
  "maxConcurrency": 8,
  "useResidentialProxy": true
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "reviews",
    "country": "BR",
    "productUrls": [
        "https://www.mercadolivre.com.br/apple-iphone-15-256-gb-preto-distribuidor-autorizado/p/MLB1027172669"
    ],
    "maxItems": 10,
    "reviewRating": "all",
    "reviewOrder": "relevance",
    "sellerUrls": [
        "https://www.mercadolivre.com.br/loja/samsung"
    ],
    "includeReviews": true,
    "includeQuestions": true,
    "includeVariations": true,
    "startUrls": [],
    "maxConcurrency": 8,
    "useResidentialProxy": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("parsebird/mercadolibre-scraper-portugues").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "reviews",
    "country": "BR",
    "productUrls": ["https://www.mercadolivre.com.br/apple-iphone-15-256-gb-preto-distribuidor-autorizado/p/MLB1027172669"],
    "maxItems": 10,
    "reviewRating": "all",
    "reviewOrder": "relevance",
    "sellerUrls": ["https://www.mercadolivre.com.br/loja/samsung"],
    "includeReviews": True,
    "includeQuestions": True,
    "includeVariations": True,
    "startUrls": [],
    "maxConcurrency": 8,
    "useResidentialProxy": True,
}

# Run the Actor and wait for it to finish
run = client.actor("parsebird/mercadolibre-scraper-portugues").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "reviews",
  "country": "BR",
  "productUrls": [
    "https://www.mercadolivre.com.br/apple-iphone-15-256-gb-preto-distribuidor-autorizado/p/MLB1027172669"
  ],
  "maxItems": 10,
  "reviewRating": "all",
  "reviewOrder": "relevance",
  "sellerUrls": [
    "https://www.mercadolivre.com.br/loja/samsung"
  ],
  "includeReviews": true,
  "includeQuestions": true,
  "includeVariations": true,
  "startUrls": [],
  "maxConcurrency": 8,
  "useResidentialProxy": true
}' |
apify call parsebird/mercadolibre-scraper-portugues --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/mercadolibre-scraper-portugues"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/cdTtvihRIKVe4mwrO/builds/DabOyFJ41oT5Jp8Rs/openapi.json