# MercadoLibre Scraper - Products & Prices, 18 LATAM Countries (`recordsdata/mercadolibre-scraper`) Actor
Scrape MercadoLibre product listings and prices across Argentina, Mexico, Brazil, Colombia, Chile and 13 more LATAM countries. Export CSV, Excel, JSON.
- **URL**: https://apify.com/recordsdata/mercadolibre-scraper.md
- **Developed by:** [RecordsData](https://apify.com/recordsdata) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 94.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage
## 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
## ๐ MercadoLibre Product & Price Scraper: 18 LATAM Countries
   
> ๐ **MercadoLibre Product & Price Scraper** is an Apify Actor that
> searches MercadoLibre and returns structured product data in seconds:
> price, discount, shipping, official-store status, and ratings across
> Argentina, Mexico, Brazil and 15 more LATAM countries.
> ๐ **Last updated:** 2026-08-28 ยท **๐ 26+ fields** per record ยท 15 of 18
> countries individually cloud-verified ยท by **RecordsData**
MercadoLibre is the largest marketplace in Latin America, but every country
runs on its own domain and its search pages actively block plain scrapers.
This Actor drives a real stealth browser through a residential proxy
matched to the country you pick, so you get real prices and real listings,
not a bot-check page.
### ๐ Table of Contents
- [๐ฏ Who this is for](#-who-this-is-for)
- [๐ What it does](#-what-the-mercadolibre-scraper-does)
- [๐ Countries covered](#-countries-covered)
- [โ๏ธ Input](#๏ธ-input)
- [๐ Output](#-output)
- [๐งพ Sample records](#-sample-records-real-data)
- [๐ How to use](#-how-to-use)
- [๐ผ Business use cases](#-business-use-cases)
- [๐ Integrate with any app](#-integrate-with-any-app)
- [๐ฐ Cost](#-cost)
- [โ FAQ](#-frequently-asked-questions)
- [๐บ๏ธ Roadmap](#๏ธ-roadmap)
### ๐ฏ Who this is for
| ๐ฏ Target Audience | ๐ก Primary Use Cases |
|---|---|
| ๐ Price intelligence / analysts | Competitor price tracking across LATAM |
| ๐๏ธ E-commerce & brand teams | Monitoring resellers, official-store compliance |
| ๐ Market researchers | Category and demand analysis per country |
| ๐งพ Procurement teams | Sourcing and price comparison |
### ๐ What the MercadoLibre Scraper does
- ๐ Searches by **keyword** on any of the **18 supported countries**
- ๐ต Returns **price, original price, discount %,** and **installments**
- ๐ Flags **free shipping** and captures the shipping note
- ๐ช Detects **official store** listings (vs. third-party sellers)
- โญ Captures the **star rating** shown on the search card
- ๐๏ธ Optional **price, condition and free-shipping filters**
- ๐ Optional **full product detail enrichment**. Description, brand, sold
count, image gallery. One extra page visit per listing
### ๐ Countries covered
**15 of 18 confirmed working** with live cloud runs (real listings, real
prices):
| โ
Working | โ
Working | โ
Working |
|---|---|---|
| ๐ฆ๐ท Argentina | ๐ช๐จ Ecuador | ๐ธ๐ป El Salvador |
| ๐ฒ๐ฝ Mexico | ๐ง๐ด Bolivia | ๐ต๐ฆ Panama |
| ๐จ๐ด Colombia | ๐ต๐พ Paraguay | ๐ฉ๐ด Dominican Republic |
| ๐จ๐ฑ Chile | ๐ฌ๐น Guatemala | |
| ๐ต๐ช Peru | ๐ณ๐ฎ Nicaragua | |
| ๐บ๐พ Uruguay | | |
| ๐ป๐ช Venezuela | | |
> โ ๏ธ **Not currently working:** ๐ง๐ท **Brazil**, ๐จ๐ท **Costa Rica**, ๐ญ๐ณ
> **Honduras**. The residential proxy connection is refused for these
> three countries on repeated, isolated tests (not a code or site-blocking
> issue; confirmed via `NS_ERROR_PROXY_CONNECTION_REFUSED`, most likely an
> account/proxy-pool allocation gap for those specific countries). The
> other 15 use the exact same code path and work reliably.
### โ๏ธ Input
| Field | Type | Default | Description |
|---|---|---|---|
| `searchTerms` | array | None | Keywords to search, e.g. `iphone 15` |
| `country` | string | `AR` | Which MercadoLibre site to search, proxy is auto-matched |
| `maxListings` | integer | `20` | Listings to collect per search term. **Free plan:** capped at 10 |
| `condition` | string | `any` | `any` / `new` / `used` |
| `priceMin` / `priceMax` | integer | None | Filter by price (local currency) |
| `freeShipping` | boolean | `false` | Only free-shipping listings |
| `sort` | string | `relevance` | `relevance` / `price_asc` / `price_desc` |
| `withDetails` | boolean | `false` | Visit each product page for description, brand, sold count, gallery |
| `proxyConfiguration` | object | `RESIDENTIAL` | Required, the Actor matches it to `country` automatically |
```json
{
"searchTerms": ["iphone 15"],
"country": "AR",
"maxListings": 40
}
```
```json
{
"searchTerms": ["zapatillas running"],
"country": "MX",
"maxListings": 20,
"freeShipping": true,
"withDetails": true
}
```
> โ ๏ธ **Good to know:** filters are applied after collecting results, so a
> strict `priceMin`/`priceMax`/`freeShipping` combination may return fewer
> items than `maxListings` for a given search term. That's expected, not a
> bug.
### ๐ Output
| Field | Description |
|---|---|
| ๐ผ `imageUrl` | Product image |
| ๐ `id` | MercadoLibre listing ID (e.g. `MLA1027172677`) |
| ๐ `title` | Listing title |
| ๐ `url` | Canonical listing URL |
| ๐ต `price` / `originalPrice` / `discountPercentage` | Current price, pre-discount price, discount % |
| ๐ฑ `currency` | ISO currency for the selected country |
| ๐ณ `installmentsText` | Raw installment-plan text as shown on the site |
| ๐ `freeShipping` / `shippingText` | Free-shipping flag + raw shipping note |
| ๐ช `officialStore` / `officialStoreName` | Official-store flag + badge text |
| ๐ฏ `promoLabel` | Any other promo badge on the listing (e.g. "Last one!") |
| ๐ค `sellerName` | Seller/brand name, when shown |
| โญ `ratingAverage` | Star rating shown on the card |
| ๐ข `isSponsored` | Whether the listing is a paid/sponsored result |
| ๐ข `position` | Rank within this search |
| ๐ `searchQuery` / ๐ `country` | Which search produced this record |
| ๐ `description` / `brand` / `soldText` / `images` | Only when `withDetails` is on |
| ๐ `scrapedAt` | When this record was scraped |
| โ `error` | Present only on failed items |
Download the dataset as **JSON, CSV, Excel, or XML** from the Apify
Console, or pull it via the API.
### ๐งพ Sample records (real data)
โถ๏ธ Click to expand. Real listings from Argentina and Mexico, 2026-08-28
```json
{
"imageUrl": "https://http2.mlstatic.com/D_Q_NP_2X_784557-MLA95493924244_102025-E.webp",
"id": "MLA1027172677",
"title": "Apple iPhone 15 128 GB Negro - Distribuidor Autorizado",
"url": "https://www.mercadolibre.com.ar/apple-iphone-15-128-gb-negro-distribuidor-autorizado/p/MLA1027172677",
"price": 1987439,
"originalPrice": 2183999,
"discountPercentage": 9,
"currency": "ARS",
"installmentsText": "Mismo precio 12 cuotas de $165.619",
"freeShipping": true,
"shippingText": "Llega gratis maรฑana",
"officialStore": true,
"officialStoreName": "APPLE TIENDA OFICIAL",
"sellerName": "Apple",
"ratingAverage": 4.9,
"isSponsored": false,
"position": 1,
"searchQuery": "iphone 15",
"country": "AR",
"scrapedAt": "2026-08-28T20:38:57.000Z",
"error": null
}
```
```json
{
"imageUrl": "https://http2.mlstatic.com/D_NQ_NP_2X_...",
"id": "MLM1027172667",
"title": "Apple iPhone 15 (128 GB) - Azul - Distribuidor Autorizado",
"url": "https://www.mercadolibre.com.mx/apple-iphone-15-128-gb-azul-distribuidor-autorizado/p/MLM1027172667",
"price": 14998,
"currency": "MXN",
"freeShipping": true,
"position": 1,
"searchQuery": "iphone 15",
"country": "MX",
"scrapedAt": "2026-08-28T20:40:41.000Z",
"error": null
}
```
### ๐ How to use
1. Sign up or log in at [console.apify.com](https://console.apify.com)
2. Open **MercadoLibre Scraper** and go to the **Input** tab
3. Add a keyword to `searchTerms` and pick a `country`
4. Set `maxListings` and click **โถ๏ธ Start**
5. Download results as JSON, CSV, Excel, or XML. Or pull them via the API
### ๐ผ Business use cases
| ๐ Competitor price tracking | ๐ช Official-store compliance |
|---|---|
| Search your category across countries weekly, export to your BI tool, and spot who's undercutting on price. | Use `officialStore` to see who's selling as an authorized reseller vs. a third party, flag unauthorized listings. |
| ๐ Cross-country market research | ๐ฏ Deal & discount monitoring |
|---|---|
| Compare pricing for the same product across Argentina, Mexico, Brazil and more to find your best-margin market. | Filter by `discountPercentage` and `promoLabel` to catch flash sales and low-stock urgency listings. |
### ๐ Integrate with any app
Pull results via the [Apify API](https://docs.apify.com/api/v2), or connect
to Make, Zapier, Google Sheets, Airbyte, n8n, or any webhook-based tool from
the Apify Console **Integrations** tab. Schedule recurring runs with
Apify's built-in **Scheduler**.
```bash
curl "https://api.apify.com/v2/acts/RecordsData~mercadolibre-scraper/run-sync-get-dataset-items?token=" \
-H "Content-Type: application/json" \
-d '{ "searchTerms": ["iphone 15"], "country": "AR", "maxListings": 20 }'
```
### ๐ฐ Cost
| Plan | What you get |
|---|---|
| ๐ Free | Up to 10 items per run (preview) |
| ๐ณ Paid | Up to 1,000,000 items per run, billed on Apify usage (compute + residential proxy) |
Cost is dominated by **one page visit per search term**, not by how many
items you keep. A single search page typically returns 40+ listings.
Setting `maxListings` closer to that natural page size (instead of many
separate low-`maxListings` searches) gives the best cost per item.
`withDetails` adds one extra page visit per listing and costs meaningfully
more. Enable it only when you need the extra fields.
### โ Frequently Asked Questions
**Does this work without a proxy?**
No. MercadoLibre blocks plain scrapers and even generic proxies on search
pages. `RESIDENTIAL`, matched to the target country, is required.
**Why did a search return 0 items?**
The site's anti-bot defenses are occasionally inconsistent. Retry the run.
If it persists for a specific country, open an issue.
**Can I filter by price or shipping?**
Yes: `priceMin`, `priceMax`, `condition`, `freeShipping`. These are
applied after collection, so a strict filter can return fewer than
`maxListings` items.
**Does it download product images?**
It returns image URLs, not the files themselves.
**Is this affiliated with MercadoLibre?**
No. See disclaimer below.
**Can I run this on a schedule?**
Yes, use Apify's built-in Scheduler.
**What happens on the free plan?**
Results are capped at 10 items per run.
### ๐บ๏ธ Roadmap
- ๐ Category and seller-ID direct filtering
- ๐ Raw start-URL passthrough (search / category / seller pages)
- ๐ค AI-generated listing summaries
- ๐ฌ Reviews content (not just the star rating)
***
> **โ ๏ธ Disclaimer:** This is an independent tool, not affiliated with,
> endorsed by, or sponsored by MercadoLibre. It only collects data that is
> publicly visible on MercadoLibre's website.
**๐ Need help or want a custom scraper?** Contact RecordsData at
.
# Actor input Schema
## `searchTerms` (type: `array`):
Keywords to search, e.g. `iphone 15`, `zapatillas running`. One search per term.
## `country` (type: `string`):
Which MercadoLibre site to search. The proxy is automatically matched to this country for reliable results.
## `maxListings` (type: `integer`):
How many product listings to collect per search term. **Free plan:** capped at 10. **Paid:** up to 1,000,000.
## `condition` (type: `string`):
Filter by product condition.
## `priceMin` (type: `integer`):
Only listings priced at or above this amount (in the local currency of the selected country).
## `priceMax` (type: `integer`):
Only listings priced at or below this amount (in the local currency of the selected country).
## `freeShipping` (type: `boolean`):
Only include listings with free shipping.
## `sort` (type: `string`):
Order search results before collecting.
## `withDetails` (type: `boolean`):
Visit each product's own page for description, brand, stock, sold count and reviews. Costs one extra page visit per listing โ worth it for price/attribute monitoring, skip it for a quick price scan.
## `proxyConfiguration` (type: `object`):
MercadoLibre blocks datacenter IPs and generic proxies on search pages โ **Residential** is required for reliable results and is already selected below. The Actor automatically matches the proxy's country to the **Country** field above.
## Actor input object example
```json
{
"searchTerms": [
"iphone 15"
],
"country": "AR",
"maxListings": 20,
"condition": "any",
"freeShipping": false,
"sort": "relevance",
"withDetails": false,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# Actor output Schema
## `results` (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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"searchTerms": [
"iphone 15"
],
"maxListings": 20,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("recordsdata/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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"searchTerms": ["iphone 15"],
"maxListings": 20,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("recordsdata/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 '{
"searchTerms": [
"iphone 15"
],
"maxListings": 20,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call recordsdata/mercadolibre-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,recordsdata/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 ` 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/3o5jmYWsIOH6OvBzZ/builds/2OesYoPbEIzBsuUfH/openapi.json