# Mercado Livre Scraper (`gio21/mercado-livre-scraper`) Actor

Scrape products from Mercado Livre (mercadolivre.com.br) by keyword. Extract title, price, rating, reviews, seller, shipping, images, and product URL. Pay per result.

- **URL**: https://apify.com/gio21/mercado-livre-scraper.md
- **Developed by:** [Gio](https://apify.com/gio21) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 495 total users, 68 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$1.75 / 1,000 product scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 Scraper — Products, Prices, Installments & Sellers

**Mercado Livre Scraper** extracts product data from [Mercado Livre Brasil](https://www.mercadolivre.com.br) by keyword: title, price, original price, discount, installments, rating, reviews, seller, condition, shipping and images. It works on Brazil's largest marketplace with **no login, no cookies and no setup**.

Export to **JSON, CSV or Excel**, pull it through the **API**, schedule it, or feed it straight to an **AI agent**. Think of it as a Mercado Livre API for product data the official one doesn't give you.

### What can you do with it?

- **💰 Price monitoring & competitor tracking** — watch prices, discounts and installment offers across sellers and react to changes.
- **📊 Market & product research** — measure demand with ratings and review counts; find gaps and bestsellers in any niche.
- **🛒 Dropshipping & product sourcing** — discover trending products and winning listings by keyword.
- **🎯 Lead generation** — collect seller names to build prospect lists.
- **🤖 AI / LLM datasets** — produce clean, structured product JSON for RAG pipelines, agents and analysis.

### What data does it extract?

| Field | Description |
|-------|-------------|
| `title` | Product title |
| `price` | Current price |
| `currency` | Local currency (always `BRL`) |
| `originalPrice` / `discount` | Pre-discount price and discount label |
| `installments` | Installment plan string (e.g. `12x R$297,96`) |
| `rating` / `reviewCount` | Social proof |
| `seller` | Seller name |
| `condition` | `Novo`, `Usado`, `Recondicionado` |
| `shipping` / `freeShipping` | Shipping label and free-shipping flag |
| `highlight` / `coupon` | Listing badges and coupon labels |
| `variations` | Variant info when present |
| `image` | Product image URL |
| `productId` / `url` | Identifier and canonical link |
| `keyword` / `scrapedAt` | Source keyword and scrape timestamp |

### Input

Provide a search keyword. The actor walks the Mercado Livre search results and extracts every product it finds.

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `keyword` | String | `iphone` | Product keyword to search on Mercado Livre (e.g. `iphone`, `notebook`, `geladeira`). Required. |
| `maxItems` | Integer | `50` | Hard cap on total products returned. |
| `maxPages` | Integer | `5` | Max search result pages to scrape (~48 products per page). |
| `sort` | String | `relevance` | Sort order: `relevance`, `price_asc`, `price_desc` or `newest`. |

### Output

One record per product:

```json
{
  "productId": null,
  "title": "Iphone 15 Verde 128gb Impecável | Sem Marcas | Face Id Ok",
  "price": 3100,
  "currency": "BRL",
  "originalPrice": null,
  "discount": null,
  "installments": "12x R$297,96",
  "rating": null,
  "reviewCount": null,
  "seller": null,
  "condition": "Usado",
  "shipping": "Frete grátis",
  "freeShipping": true,
  "highlight": null,
  "coupon": null,
  "variations": null,
  "image": "https://http2.mlstatic.com/D_Q_NP_2X_905398-MLB113531106755_062026-E.webp",
  "url": "https://www.mercadolivre.com.br/iphone-15-verde-128gb-impecavel--sem-marcas--face-id-ok/up/MLBU4093580131",
  "keyword": "iphone 15",
  "scrapedAt": "2026-06-23T01:45:33.141Z"
}
```

#### Field notes

- `originalPrice` / `discount`: discount signals. Both are `null` when the listing is not on sale.
- `installments`: the installment plan string as shown on the listing (e.g. `12x R$297,96`); `null` when none is offered.
- `rating` / `reviewCount` / `seller`: `null` when Mercado Livre doesn't expose them in the search card for that listing.
- `condition`: the listing condition in Portuguese — `Novo`, `Usado` or `Recondicionado`.
- `shipping` / `freeShipping`: the shipping label plus a boolean flag; `freeShipping` is `true` when free shipping is offered.
- `highlight` / `coupon` / `variations`: badge, coupon and variant info; `null` when absent.

### Integrations

- **API** — start runs and fetch the dataset via the [Apify API](https://docs.apify.com/api/v2) (REST/JSON) or the JS/Python clients. A Mercado Livre API for the data the official one doesn't expose.
- **Schedule & monitor** — run on a [schedule](https://docs.apify.com/platform/schedules) for recurring price monitoring; get notified on failures.
- **AI agents / MCP** — expose this actor to ChatGPT, Claude and other assistants through the [Apify MCP server](https://mcp.apify.com) so an AI can pull live Mercado Livre data on demand.
- **No-code** — pipe results into Make, Zapier, Google Sheets, Slack or your database with Apify [integrations](https://docs.apify.com/platform/integrations) and webhooks.

### FAQ

**How does Mercado Livre Scraper work?**
It searches Mercado Livre exactly as a shopper would, reads each product card from the results, copies the visible data and organizes it into a structured dataset — only much faster, and at scale.

**Is it legal to scrape Mercado Livre?**
The actor collects only **publicly available** product information (no login, no personal data). As with any scraping, you are responsible for how you use the data and for complying with applicable laws and terms. See [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/)

**Do I need a Mercado Livre account or login?**
No. No account, cookies or credentials — proxy and unblocking are handled automatically.

**How many results can I get per keyword?**
Each search page returns ~48 products. Use `maxPages` and `maxItems` to control depth; for broad coverage run several specific keywords or change the `sort` order.

**Why are some fields null?**
Mercado Livre doesn't show every detail in the search card — rating, review count, seller or discount may be absent for a given listing and are returned as `null` rather than fabricated.

**Can I sort the results?**
Yes — set `sort` to `relevance`, `price_asc`, `price_desc` or `newest`.

**Can I get the data through an API or connect it to AI?**
Yes — run it via the Apify API/clients, or expose it to AI assistants through the Apify MCP server. See **Integrations** above.

**How much does it cost?**
Pay-per-event: **$0.0025 per product** ($2.50 per 1,000 products) plus a $0.02 run-start fee, from Nov 26, 2026 (until then $0.00175 per product, no start fee). Free-plan runs return up to 5 products.

### Related Actors

Building a data pipeline? Pair Mercado Livre Scraper with:

- **[Mercado Libre Scraper](https://apify.com/gio21/mercado-libre-scraper)** — products and prices from Mercado Libre across Spanish-speaking Latin America.
- **[Mercado Livre Product Detail](https://apify.com/gio21/mercadolivre-product-detail)** — full product page by URL: variants, full image set, seller and reviews.
- **[Magazine Luiza Scraper](https://apify.com/gio21/magazine-luiza-scraper)** — products and prices from Magazine Luiza.
- **[Shopee Scraper](https://apify.com/gio21/shopee-scraper)** — products, prices and sold-volume estimates from Shopee.

***

### ⭐ Like this actor?

If it saved you time, please take 30 seconds to [leave a review on the Apify Store](https://apify.com/gio21/mercado-livre-scraper) — it's the single biggest way to support continued development.

# Actor input Schema

## `keyword` (type: `string`):

Product keyword to search on Mercado Livre Brasil. The actor walks the search results for this term. Use specific terms for cleaner results. Example: "iphone 15" (also valid: "notebook", "geladeira").

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

Hard cap on the total number of products returned across all pages. Example: 50. Free-plan runs are limited to 5 products regardless of this value.

## `maxPages` (type: `integer`):

Maximum number of search-result pages to scrape (each page holds ~48 products). Acts as a depth limit alongside maxItems. Example: 5.

## `sort` (type: `string`):

How to order the search results before scraping. Example: "relevance" for default ranking, or "price_asc" to find the cheapest listings first.

## Actor input object example

```json
{
  "keyword": "iphone",
  "maxItems": 50,
  "maxPages": 3,
  "sort": "relevance"
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped Mercado Livre products with title, price, rating, reviews, seller, shipping, image, and URL.

# 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 = {
    "keyword": "iphone",
    "maxItems": 50,
    "maxPages": 3,
    "sort": "relevance"
};

// Run the Actor and wait for it to finish
const run = await client.actor("gio21/mercado-livre-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 = {
    "keyword": "iphone",
    "maxItems": 50,
    "maxPages": 3,
    "sort": "relevance",
}

# Run the Actor and wait for it to finish
run = client.actor("gio21/mercado-livre-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 '{
  "keyword": "iphone",
  "maxItems": 50,
  "maxPages": 3,
  "sort": "relevance"
}' |
apify call gio21/mercado-livre-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gio21/mercado-livre-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/4hWYclSRErOaeFtlO/builds/lDoIQJFCpcWc5ui1n/openapi.json