# Mercado Livre Scraper (português Brasil) (`pegai/mercadolivre-deals-scraper`) Actor

Extraia ofertas do dia, ofertas relâmpago e descontos por categoria do Mercado Livre Brasil. JSON com preços, % de desconto, vendedor, avaliação, parcelas e frete grátis — para monitoramento de preços, dropshipping e inteligência de e-commerce. | Scrape Mercado Livre Brazil (MercadoLibre BR) deals.

- **URL**: https://apify.com/pegai/mercadolivre-deals-scraper.md
- **Developed by:** [Pega AI](https://apify.com/pegai) (community)
- **Categories:** E-commerce
- **Stats:** 29 total users, 9 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Mercado Livre Ofertas & Promoções — Scraper 🇧🇷

Extraia **dados estruturados das ofertas do Mercado Livre Brasil** — o maior marketplace da América Latina — em segundos. O scraper coleta as páginas oficiais de ofertas (ofertas do dia, ofertas relâmpago, descontos por categoria) e devolve JSON limpo, pronto para **monitoramento de preços, inteligência de e-commerce, pesquisa para dropshipping ou automação de afiliados**. Sem programar — rode pelo painel, agende ou chame pela API.

Feito por quem roda pipelines de dados do Mercado Livre em produção desde o início de 2026.

### O que você recebe por produto

```json
{
    "title": "Controle Xbox Wireless Series X|s Carbon Black",
    "url": "https://www.mercadolivre.com.br/...",
    "productId": "MLB5139965320",
    "price": 331.55,
    "priceIsPix": true,
    "originalPrice": 520.18,
    "discountPct": 36,
    "currency": "BRL",
    "installmentPrice": 349.9,
    "installmentText": "R$349,90 em 10x sem juros",
    "seller": "EasyTech",
    "rating": 4.8,
    "reviewsCount": 93378,
    "freeShipping": true,
    "imageUrl": "https://http2.mlstatic.com/...webp",
    "sourceUrl": "https://www.mercadolivre.com.br/ofertas?...",
    "scrapedAt": "2026-07-03T18:38:59.752Z"
}
```

> Os nomes dos campos ficam em inglês para facilitar a integração com planilhas, bancos de dados e agentes de IA.

### Casos de uso

- **Monitoramento de preços e descontos** — agende execuções diárias e acompanhe como os preços se movem.
- **Inteligência de e-commerce** — veja o que o maior marketplace do Brasil está descontando, por categoria.
- **Comunidades de ofertas e afiliados** — alimente grupos de WhatsApp/Telegram com ofertas novas (é exatamente para isso que usamos em produção).
- **Pesquisa de mercado** — vendedores, avaliações, número de reviews e preço no Pix em 16 categorias curadas.

### Como usar

1. Escolha o **modo**:
   - `Ofertas do dia` — a página principal de ofertas;
   - `Categorias` — 16 categorias curadas (celulares, games, eletrodomésticos, beleza, pet, automotivo…);
   - `URLs personalizadas` — cole qualquer URL de `mercadolivre.com.br/ofertas` com seus próprios filtros.
2. Defina `maxItems` (limite rígido — você nunca paga por mais que isso) e, opcionalmente, `minDiscountPct` para manter só as ofertas de verdade.
3. Rode uma vez, agende, ou chame pela API / n8n / Make.

Cada página de resultados traz ~48 produtos. `maxPagesPerSource` controla a profundidade da paginação.

Os resultados ficam em um dataset da Apify que você **exporta como JSON, CSV, Excel ou XML**, ou puxa direto para o Google Sheets, seu banco de dados ou qualquer cliente HTTP via API do dataset.

### Preço

Pague por resultado — você só é cobrado pelos produtos realmente enviados ao dataset, limitado por `maxItems`. Páginas que falham nunca são cobradas.

### Perguntas frequentes

**Precisa de proxy ou conta?** Não. O actor usa uma técnica de leitura via proxy estável em produção há meses. Para volumes agendados muito grandes, você pode opcionalmente adicionar sua própria chave do [Jina Reader](https://jina.ai) no input.

**É legal?** O actor extrai apenas **dados públicos** (sem login, sem dados pessoais) das páginas públicas de ofertas, a uma taxa de requisição educada.

**Uma categoria retornou poucos itens?** As ofertas relâmpago giram ao longo do dia — agende várias execuções para capturá-las.

**Algo quebrou?** O Mercado Livre muda o layout de vez em quando. Abra uma issue na aba Issues do actor — correções saem em até 48h.

***

#### English summary

Scrape **Mercado Livre Brazil** (MercadoLibre BR) deals and offers into clean JSON: prices, discount %, seller, rating, installments and free shipping. Ideal for price monitoring, e-commerce intelligence and dropshipping research. Three modes: deals of the day, 16 curated categories, or custom offer URLs. Pay per result, capped by `maxItems`. Field names are in English for easy integration.

### Roadmap

- Scraper de avaliações de produtos (actor separado)
- Scraper de catálogo de vendedor/loja
- Histórico de preços via execuções agendadas + guia de merge de datasets
- Versão para MercadoLibre hispânico (Argentina, México, Chile)

***

*Este Actor não é afiliado nem endossado pelo MercadoLibre, Inc. O ícone usa um glifo do [Font Awesome](https://fontawesome.com) ([CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)).*

# Actor input Schema

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

O que coletar: ofertas do dia, uma seleção de categorias curadas, ou URLs de ofertas que você fornecer abaixo.

## `categories` (type: `array`):

Categorias de ofertas curadas do Mercado Livre.

## `customUrls` (type: `array`):

Qualquer URL de mercadolivre.com.br/ofertas, ex.: https://www.mercadolivre.com.br/ofertas?category=MLB1051

## `maxPagesPerSource` (type: `integer`):

Quantas páginas de resultados buscar por categoria/URL (cada página traz ~48 produtos).

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

Limite rígido de produtos enviados ao dataset (é o que você paga — a execução nunca ultrapassa isso).

## `minDiscountPct` (type: `integer`):

Ignora produtos com desconto menor que esta porcentagem. 0 = sem filtro.

## `jinaApiKey` (type: `string`):

Chave opcional do jina.ai para limites de requisição maiores em execuções grandes. Execuções pequenas funcionam sem ela.

## Actor input object example

```json
{
  "mode": "deals",
  "categories": [
    "celulares",
    "informatica",
    "games"
  ],
  "customUrls": [
    "https://www.mercadolivre.com.br/ofertas"
  ],
  "maxPagesPerSource": 1,
  "maxItems": 100,
  "minDiscountPct": 0
}
```

# 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 = {
    "customUrls": [
        "https://www.mercadolivre.com.br/ofertas"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pegai/mercadolivre-deals-scraper").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 = { "customUrls": ["https://www.mercadolivre.com.br/ofertas"] }

# Run the Actor and wait for it to finish
run = client.actor("pegai/mercadolivre-deals-scraper").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 '{
  "customUrls": [
    "https://www.mercadolivre.com.br/ofertas"
  ]
}' |
apify call pegai/mercadolivre-deals-scraper --silent --output-dataset

```

## MCP server setup

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

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/gKMT5fnckMAkNIeLz/builds/BJmDkmNdxel2XcNmH/openapi.json