# MercadoLibre Scraper — Products, Prices & Sellers (`hipersoft/mercadolibre-scraper`) Actor

Scrape MercadoLibre / MercadoLivre product listings by search query or product URL: title, price, currency, condition, sold quantity, rating, reviews, seller, free shipping, image and link. Argentina, Mexico, Brazil, Colombia and Chile. For price and market research.

- **URL**: https://apify.com/hipersoft/mercadolibre-scraper.md
- **Developed by:** [hiper soft](https://apify.com/hipersoft) (community)
- **Categories:** E-commerce, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.001 / item scraped

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/actors/running/actors-in-store.md#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

## MercadoLibre Scraper — Scrape Products, Prices & Sellers (LatAm)

**Scrape MercadoLibre and MercadoLivre** product listings at scale into clean JSON, CSV, Excel or XML. This MercadoLibre scraper extracts **title, price, currency, condition, sold quantity, rating, reviews, seller, free shipping, image and product link** for every result across **Argentina, Mexico, Brazil, Colombia and Chile**. A fast, no-code way to build a Latin American e-commerce dataset — no login and nothing to set up.

MercadoLibre (MercadoLivre in Brazil) is the largest online marketplace in Latin America, so collecting product and price data by hand across country sites is slow. This Actor turns any keyword or product URL into a structured product feed in one run — an easy, cheap alternative to copying listings manually.

### What does the MercadoLibre Scraper do?

The MercadoLibre Scraper crawls public **product listings** by **country market and search query**, or by **specific product URLs**. Pick a country (like Argentina or Mexico), type a query such as `notebook`, `iphone 15` or `zapatillas nike`, set a limit, and it returns structured data points — product title, price, currency, condition, how many were sold, rating and reviews, the seller, whether shipping is free, the image and a direct link — ready for analytics, datasets, price monitoring, LLM pipelines or dashboards.

### What data can you scrape from MercadoLibre?

| Group | Fields |
|---|---|
| 🏷️ **Product** | title, condition (new / used) |
| 💰 **Price** | price, currency |
| 📦 **Demand** | sold quantity, free shipping |
| ⭐ **Reviews** | rating, reviews count |
| 🏬 **Seller** | seller / store name |
| 🖼️ **Media** | thumbnail image |
| 🔗 **Link** | direct product URL |
| 🆔 **Identifiers** | product ID |

### Use cases

- **Price monitoring & repricing** — track competitor prices and stock across LatAm marketplaces.
- **Market & demand research** — see which products, sellers and price points move, by country.
- **Catalog & assortment analysis** — build a product catalog with prices, conditions and ratings.
- **Dropshipping & sourcing** — find products, sellers and free-shipping offers to resell.
- **Brand & seller monitoring** — watch how a brand or store is listed and priced.
- **Build an e-commerce dataset** — thousands of products with prices, reviews and sellers for BI or ML.

### How to scrape MercadoLibre data

1. Click **Try for free / Start** to open the MercadoLibre Scraper.
2. Choose a **country** market (e.g. Argentina, Mexico, Brazil).
3. Type a **search query** such as `notebook`, `iphone 15` or `zapatillas nike` — and/or paste product URLs.
4. Set **Max items**, then click **Run**.
5. Download the results as **JSON, CSV, Excel or XML**, or pull them from the API.

### Input

Search a country market, and/or pass specific product URLs, and cap the number of items.

```json
{
  "search": "notebook",
  "country": "ar",
  "maxItems": 100
}
```

| Field | Type | Description |
|---|---|---|
| `search` | string | Search query, e.g. `notebook`, `iphone 15`, `zapatillas nike`. Leave empty to only scrape product URLs. |
| `country` | string | Country market: `ar` (Argentina), `mx` (Mexico), `br` (Brazil / MercadoLivre), `co` (Colombia) or `cl` (Chile). Sets site, language and currency. |
| `itemUrls` | array | Optional list of specific product page URLs to scrape directly. |
| `maxItems` | integer | Maximum products to collect from the search (default 100). Product URLs are always all scraped. |

#### Scrape by country

Set `country` to any supported market to target that MercadoLibre site. Run several countries to build a region-wide LatAm dataset.

#### Scrape specific products

Add product page URLs to `itemUrls` to scrape exactly those items — on their own or alongside a search.

### Output

Each product is one dataset item:

```json
{
  "id": "MLA1234567890",
  "title": "Notebook Lenovo IdeaPad 15.6\" 8GB 256GB SSD",
  "price": 899999,
  "currency": "ARS",
  "condition": "new",
  "soldQuantity": 250,
  "rating": 4.7,
  "reviewsCount": 132,
  "seller": "Lenovo Store",
  "freeShipping": true,
  "url": "https://articulo.mercadolibre.com.ar/MLA-1234567890-notebook-lenovo",
  "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_123456-MLA.jpg"
}
```

#### Output schema

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | MercadoLibre product identifier. |
| `title` | string | Product title. |
| `price` | number | Current price in the marketplace currency. |
| `currency` | string | ISO currency code (e.g. `ARS`, `MXN`, `BRL`, `COP`, `CLP`). |
| `condition` | string | `new` or `used` where available. |
| `soldQuantity` | number | Units sold, where shown. |
| `rating` | number | Average rating (0–5), where available. |
| `reviewsCount` | number | Number of reviews, where available. |
| `seller` | string | Seller or store name, where available. |
| `freeShipping` | boolean | Whether the listing offers free shipping. |
| `url` | string (URL) | Direct link to the product page. |
| `thumbnail` | string (URL) | Product image URL. |

### Need more e-commerce data?

Building a wider product or price dataset? Pair this with our other marketplace scrapers:

- [Amazon Product Scraper](https://apify.com/hipersoft/amazon-product-scraper) — Amazon products, prices and reviews across marketplaces.
- [eBay Scraper](https://apify.com/hipersoft/ebay-scraper) — eBay active and sold listings with prices and conditions.
- [Shopify Product Scraper](https://apify.com/hipersoft/shopify-product-scraper) — products and variants from any Shopify store.
- [Vinted Scraper](https://apify.com/hipersoft/vinted-scraper) — second-hand fashion listings with prices and sellers.

### FAQ

**Do I need a login or an API key for MercadoLibre?**
No. The MercadoLibre Scraper needs no login, no account and no key — just choose a country, add a query and run.

**Which countries does it cover?**
Argentina (`mercadolibre.com.ar`), Mexico (`mercadolibre.com.mx`), Brazil / MercadoLivre (`mercadolivre.com.br`), Colombia (`mercadolibre.com.co`) and Chile (`mercadolibre.cl`).

**How many products can I scrape per run?**
As many as you like. Use `maxItems` to cap the count, and run multiple countries or queries to scale to thousands of products.

**Can I scrape specific products by URL?**
Yes. Add MercadoLibre product page URLs to `itemUrls` and they will be scraped directly, with or without a search.

**Does it include price and currency?**
Yes. Every item returns the current `price` and the marketplace `currency` (for example `ARS`, `MXN` or `BRL`), so multi-country data stays comparable.

**How much does it cost?**
You pay only for the products you get, which makes it one of the cheapest ways to collect LatAm marketplace data at scale. See the Pricing tab for current rates.

**What export formats are supported?**
JSON, CSV, Excel and XML, plus webhooks and the Apify API.

**Can I automate or integrate the MercadoLibre Scraper with n8n?**
Yes. Use the [Apify node for n8n](https://docs.apify.com/platform/integrations/n8n) to run this Actor and pipe products straight into an n8n workflow — trigger on a schedule, then route the data to a database, spreadsheet or alert. It also works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2) and [webhooks](https://docs.apify.com/platform/integrations/webhooks).

**Is scraping MercadoLibre legal?**
The Actor collects only public product listings — no private or personal data. You are responsible for how you use the data and for complying with MercadoLibre's terms and applicable laws.

### Related Actors

- [Amazon Product Scraper](https://apify.com/hipersoft/amazon-product-scraper) — Amazon products, prices and reviews.
- [eBay Scraper](https://apify.com/hipersoft/ebay-scraper) — eBay active and sold listings.
- [Shopify Product Scraper](https://apify.com/hipersoft/shopify-product-scraper) — products from any Shopify store.
- [Vinted Scraper](https://apify.com/hipersoft/vinted-scraper) — second-hand fashion listings.

### Notes

Original clean-room implementation. Returns only public product listings — no private or personal data; you are responsible for how you use the data and for complying with MercadoLibre's terms. This is an independent tool and is not affiliated with or endorsed by MercadoLibre / MercadoLivre.

# Actor input Schema

## `search` (type: `string`):

What to search for on MercadoLibre / MercadoLivre, e.g. "notebook", "iphone 15" or "zapatillas nike". Leave empty if you only want to scrape specific product URLs.

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

Which MercadoLibre country market to search: Argentina, Mexico, Brazil (MercadoLivre), Colombia or Chile. Sets the site, language and currency.

## `itemUrls` (type: `array`):

Optional list of specific MercadoLibre / MercadoLivre product page URLs to scrape directly, in addition to (or instead of) a search.

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

Maximum number of products to collect from the search. Product URLs are always all scraped.

## `proxyConfiguration` (type: `object`):

Proxy configuration. Leave the default — it is tuned for reliable results.

## Actor input object example

```json
{
  "search": "notebook",
  "country": "ar",
  "itemUrls": [
    "https://articulo.mercadolibre.com.ar/MLA-1234567890-example"
  ],
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

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

The results as dataset items.

# 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 = {
    "search": "notebook"
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/mercadolibre-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 = { "search": "notebook" }

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/mercadolibre-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 '{
  "search": "notebook"
}' |
apify call hipersoft/mercadolibre-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/mercadolibre-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/w5zWpffDL75wJvBlX/builds/o311wN6rmns1FMAly/openapi.json