Mercado Libre Scraper (MercadoLibre) | MX, AR, CO, CL

Mercado Libre Scraper (MercadoLibre) | MX, AR, CO, CL

US$0.80 per 1,000 listings + US$0.05 per run. Local residential proxies and retries are included; blocked pages and failed queries are never charged.

Search Mercado Libre (MercadoLibre) Mexico, Argentina, Colombia and Chile by keyword and get every listing back as structured data: price, crossed-out price, discount %, installments, seller, official-store flag, rating, units sold, shipping flags and more, in the local currency.

• 4 countries, one actor: pick MX, AR, CO or CL and the run uses a residential IP from that country.
• Up to 20 queries per run and up to 1,000 listings per query, in the order Mercado Libre ranks them (position).
• Sponsored ads flagged (isAd: true) or removed with one checkbox, so you can keep organic results only.

Country	Site	Currency
MX Mexico (default)	mercadolibre.com.mx	MXN
AR Argentina	mercadolibre.com.ar	ARS
CO Colombia	mercadolibre.com.co	COP
CL Chile	mercadolibre.cl	CLP

En español: extrae los resultados de búsqueda de Mercado Libre México, Argentina, Colombia y Chile por palabra clave: precio, precio tachado, descuento, meses sin intereses o cuotas, vendedor, tienda oficial, calificación, unidades vendidas y envío, en una tabla lista para Excel. Hasta 20 búsquedas por ejecución y hasta 1.000 publicaciones por búsqueda, con proxy residencial del país incluido. Ideal para monitorear precios, seguir a la competencia e investigar el mercado. Cuesta US$0,80 por cada 1.000 publicaciones más US$0,05 por ejecución; las páginas bloqueadas no se cobran.

What you get

One row per listing. Real output from an "audifonos bluetooth" search on Mercado Libre Mexico:

{
  "country": "MX",
  "query": "audifonos bluetooth",
  "position": 6,
  "itemId": "MLM3933441312",
  "productId": "MLM52845211",
  "title": "Auriculares in-ear inalámbricos Samsung Galaxy Buds Core SM-R410N negro",
  "url": "https://www.mercadolibre.com.mx/auriculares-in-ear-inalambricos-samsung-galaxy-buds-core-sm-r410n-negro/p/MLM52845211",
  "price": 672.6,
  "originalPrice": 999,
  "discountPct": 32,
  "currency": "MXN",
  "installments": "24 meses de $ 40.64",
  "freeShipping": false,
  "isFull": true,
  "sellerName": "samsung",
  "isOfficialStore": true,
  "rating": 4.9,
  "soldQuantity": 10000,
  "isAd": false,
  "categoryId": "MLM7533",
  "domainId": "MLM-HEADPHONES",
  "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_953007-MLA100016696047_122025-O.webp",
  "scrapedAt": "2026-10-18T22:08:38.987Z"
}

Field	Meaning
country / query / position	The site searched, the search term and where the listing ranked
price / originalPrice / discountPct	Current price, crossed-out price and discount %
currency	Local currency: MXN, ARS, COP or CLP
installments	Installment plan as shown on the card (e.g. "15 meses sin intereses")
sellerName / isOfficialStore	Seller and whether it's an official store
rating / soldQuantity	Star rating and units sold, when the card displays them
freeShipping / isFull	Free shipping and Fulfillment (FULL) flags
isAd	true for sponsored placements — filter with Include sponsored ads
url / itemId / productId	Canonical listing link and IDs — feed them to the reviews actor
error	Set only on failed queries — those rows are not charged

Use cases

• Competitor price monitoring: schedule the same queries every day and track price, originalPrice and discountPct per itemId.
• Repricing: see where your listing ranks (position) against the sellers around it, with their price and installment plan.
• Cross-country comparison: run the same term in MX, AR, CO and CL to compare prices, official stores and sales in each market.
• Niche and product research: compare soldQuantity, rating and the number of official stores across terms before you enter a category.
• Ads vs organic: keep isAd to measure how much of the first page is paid placement.

How to use it

1. Choose the Country: Mexico, Argentina, Colombia or Chile.
2. Type search terms into Search queries exactly as a shopper would ("audifonos bluetooth", "freidora de aire") — up to 20 per run.
3. Set Max items per query (default 100, up to 1,000) — the actor follows the site's pagination until the limit or the last page.
4. Leave Include sponsored ads on to keep paid placements (marked isAd: true), or turn it off for organic-only results.
5. Run and export to CSV, Excel or JSON — or schedule it daily to track prices over time.

Input	Type	Default	Notes
country	string	MX	MX, AR, CO or CL; anything else falls back to MX
queries	array of strings	— (required)	Up to 20 per run; duplicates are removed
maxItemsPerQuery	integer	100	1 to 1,000
includeAds	boolean	true	false = organic results only

To compare countries, run once per country (one task per country works well with the Apify scheduler).

Pricing

Pay per event: a small start fee opens a residential session in the chosen country, then a flat fee per listing delivered. Blocked pages and failed queries are never charged — and every run respects the maxTotalChargeUsd budget you set on Apify.

Event	Price
Listing delivered	US$0.0008
Run start	US$0.05

Scenario	Approximate cost
100 listings (1 query)	~US$ 0.13
1,000 listings (1 query, max per query)	~US$ 0.85
10,000 listings (10 queries)	~US$ 8.05

Run cost limit. Every search term costs at least one page load on a residential proxy. If a run keeps costing more than the results it delivers (for example dozens of search terms that return almost nothing, or a long streak of blocked or missing pages), it stops opening new search terms: the ones not opened come back as rows with error: "run-cost-limit" and are not charged. The first search term always runs and normal runs are not affected.

Run it from code

Replace <YOUR_APIFY_TOKEN> with your token from Apify Console → Settings → API & Integrations.

cURL (waits for the run and returns the items):

curl -X POST "https://api.apify.com/v2/acts/gangary~mercado-libre-search-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"country": "MX", "queries": ["audifonos bluetooth", "freidora de aire"], "maxItemsPerQuery": 100, "includeAds": false}'

Python (pip install apify-client):

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("gangary~mercado-libre-search-scraper").call(
    run_input={"country": "AR", "queries": ["zapatillas running"], "maxItemsPerQuery": 100}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["position"], item.get("price"), item.get("currency"), item.get("title"))

Node.js (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('gangary~mercado-libre-search-scraper').call({
    country: 'CO',
    queries: ['audifonos bluetooth'],
    maxItemsPerQuery: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, items[0]);

The synchronous endpoint waits up to 300 seconds; for big runs (many queries × 1,000 items) start the run asynchronously and read the dataset when it finishes.

Integrations

Everything below is built into Apify, no extra setup on our side:

• Schedules: run the same queries daily or hourly for price tracking (one schedule or task per country).
• Webhooks: get a call to your own endpoint when a run finishes.
• Make, n8n and Zapier: send each run's listings to Google Sheets, a database, Slack or your repricing tool.
• Google Drive: drop each run's export into a shared folder.
• Exports: JSON, CSV, Excel, XML or HTML from the dataset, or straight from the API.

Use with AI agents (MCP)

Apify runs a hosted MCP server, so Claude, Cursor, VS Code and other MCP clients can call this actor as a tool. Add this server URL to your client (it signs in with OAuth on first use, or send Authorization: Bearer <YOUR_APIFY_TOKEN>):

https://mcp.apify.com?tools=gangary/mercado-libre-search-scraper

Then ask in plain words, e.g. "Compare the 30 cheapest organic 'freidora de aire' listings on Mercado Libre Mexico and Colombia." Setup details for each client: Apify MCP server docs.

FAQ

Is scraping Mercado Libre legal? The actor reads publicly listed search results — no login, no paywall bypass, and no personal data beyond the public store/seller name already shown on every listing card.

Why do some queries come back blocked? Mercado Libre runs aggressive anti-bot protection. When a session gets blocked, the actor drops it, opens a fresh residential IP in the same country and retries the same page — up to 3 times. If it still fails, the query is abandoned with an error row and you are not charged for it.

Is proxy included? Yes — residential proxies in Mexico, Argentina, Colombia and Chile are included in the per-listing price. Nothing to configure.

Can I search several countries in one run? No, one country per run. Run it once per country, or create one saved task per country and schedule them.

How many results can I get per search term? Up to 1,000 per query per run. Mercado Libre itself stops serving results after ~2,000 per search term, so no scraper can go deeper on a single term. For more volume, split the term ("audifonos bluetooth", "audifonos bluetooth deportivos").

Is position the same order a shopper sees? Yes. Listings come in the order of the site's own search pages at the moment of the run, sponsored placements included unless you turn them off.

Why are rating, soldQuantity or installments empty on some rows? They are filled only when the listing card shows them. New listings without sales or reviews have no rating or sold count on Mercado Libre either.

What does a run with no results cost? Only the US$0.05 start fee. Listings are charged one by one as they are delivered, and error rows are free. You can also cap any run with Max total charge on Apify.

How do I get reviews and the full product page? Take the url values from this actor and paste them into the MercadoLibre Product & Reviews Scraper: specs, description, stock and customer reviews, with countries mixed in one run.

What about Brazil? Brazil runs on a separate domain (Mercado Livre). Use the Mercado Livre Scraper for it.

Honest limitations

• Mercado Libre itself serves at most ~2,000 results per search term — nothing can scrape deeper than the site offers.
• Per query this actor collects up to 1,000 items per run; for more volume, spread terms across queries (up to 20 per run) or schedule multiple runs.
• Ratings, sold counts and installments appear only when the listing card displays them.
• One country per run. Peru, Uruguay and other Mercado Libre sites are not supported yet.

Changelog

• 2026-11-11: run cost limit: a run stops opening new search terms when it keeps costing more than it delivers; those come back as run-cost-limit rows, not charged. A browser session that fails to connect now retries on a new IP instead of returning timeout.
• 2026-10-31: lower price per listing: US$0.80 per 1,000 (was US$1.50); run start US$0.05.
• 0.1.5 (2026-10-28): fixed Colombia and Chile searches that could come back empty (no-data). The actor now waits longer for slow pages and switches to a new session when it gets a captcha.
• 2026-10-18: first public release (Mexico, Argentina, Colombia, Chile).

From the same maker

• MercadoLibre Product & Reviews Scraper — full product page data plus customer reviews for MX, AR, CO and CL.
• Mercado Livre Scraper (Brazil) — the same search data for Mercado Livre Brazil.
• Mercado Libre Seller Scraper — every listing of one seller or official store, past the 2,000-result limit.
• Mercado Libre Price Tracker — daily price, stock and Buy Box checks on your own list of listings.

---

If this actor helped you, a rating on its Store page helps others find it. Something broke or a field is missing? Open an issue on the actor's Issues tab.

Keywords: mercado libre scraper, scraper mercado libre méxico, mercado libre argentina scraper, mercado libre colombia, mercado libre chile, extraer precios mercado libre, monitoreo de precios, mercado libre price scraper, competitor price tracking latam, e-commerce scraper latin america, market research mexico.