MercadoLibre Search Scraper — Price, Seller & Rating

Scrape MercadoLibre search results across 11 Latin American marketplaces. Give it a keyword or a search/category URL and get back clean, structured product cards: title, price, discount, seller, rating, free-shipping, installments, condition, and the result position — ready for price monitoring, market research, and AI agents.

What it does

For each keyword (or pasted search URL) the actor opens the MercadoLibre results page, paginates through the listing, and returns one row per product card. It auto-detects the country from the marketplace domain and renders pages through residential proxies so the data matches what a real shopper in that country sees.

When to use it

• Price & promo monitoring — track prices, discounts, and installments for a search term over time.
• Market & competitor research — see who ranks for a keyword, official stores vs resellers, ratings, and ad placements.
• Catalog & assortment analysis — pull the top N results for many keywords across countries.
• Feed an AI agent — narrow input (keyword + country), structured JSON out, predictable per-result cost.

Need full product detail pages (description, all photos, attributes, seller reputation)? This actor returns search-result cards, not product detail pages. Use it to discover items, then enrich the url / itemId separately.

Supported countries

Mexico (MX), Argentina (AR), Brazil/Mercado Livre (BR), Chile (CL), Colombia (CO), Uruguay (UY), Peru (PE), Ecuador (EC), Venezuela (VE), Bolivia (BO), Paraguay (PY).

Output

One dataset row per result card:

Field	Description
position	1-based rank in the run
itemId	MercadoLibre item id, e.g. MLM1422978828
title	Product title
price	Current price (number)
currency	Marketplace currency, e.g. MXN
originalPrice	Struck-through price before discount, when shown
discountPercent	Discount %, when shown
condition	new / used / refurbished, when labelled
sellerName	Seller or official store, when shown
rating	Average star rating 0–5, when shown
reviewsCount	Number of reviews, when shown
freeShipping	True when the card advertises free shipping
shippingText	Raw shipping label, e.g. Llega gratis hoy
installments	Installments text, e.g. 12 meses sin intereses de $675
thumbnail	Product image URL
isSponsored	True for ads / promoted listings
url	Product page URL
country	Marketplace country code

Example row

{
  "position": 5,
  "itemId": "MLM63043376",
  "title": "Celular Motorola Moto G06 256gb 4gb Color Verde",
  "price": 2117,
  "currency": "MXN",
  "originalPrice": 5999,
  "discountPercent": 64,
  "sellerName": "Telmov",
  "rating": 4.8,
  "freeShipping": true,
  "shippingText": "Llega gratis hoy",
  "installments": "24 meses de $127.94",
  "thumbnail": "https://http2.mlstatic.com/D_Q_NP_2X_927719-MLA100483414444_122025-E.webp",
  "isSponsored": false,
  "url": "https://www.mercadolibre.com.mx/celular-motorola-moto-g06-256gb-4gb-color-verde/p/MLM63043376",
  "country": "MX"
}

Pricing

Pay-per-event:

• Actor start — $0.005 per run (covers browser launch + proxy warm-up).
• Product listed — $0.004 per result card returned.

A 50-result run costs about $0.21; 1,000 results about $4.00 plus the start fee. You are only billed for results actually returned.

Input

Field	Type	Description
searchQueries	string[]	Keywords to search, one per line. Defaults to celular.
startUrls	string[]	Full MercadoLibre search/category URLs; country auto-detected.
country	enum	Marketplace for keyword searches. Default MX.
sort	enum	relevance, price_asc, price_desc, most_recent.
maxResults	integer	Total cards across all queries. Default 50, max 5000.
enableCaptchaSolver	boolean	Solve reCAPTCHA walls automatically. Default true.
proxyConfiguration	proxy	Primary proxy. Residential strongly recommended.

Example input

{
  "searchQueries": ["celular samsung", "notebook gamer"],
  "country": "MX",
  "sort": "price_asc",
  "maxResults": 100
}

Call from the API

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~mercadolibre-search-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "searchQueries": ["celular"], "country": "MX", "maxResults": 50 }'

Call from JavaScript (apify-client)

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('khadinakbar/mercadolibre-search-scraper').call({
    searchQueries: ['notebook gamer'],
    country: 'AR',
    maxResults: 200,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Reliability & proxies

MercadoLibre serves a suspicious-traffic / captcha wall to datacenter and out-of-country IPs. For the best success rate, set the proxy to Apify Residential with the country that matches your search. If a page is blocked, the actor automatically rotates to a fresh in-country residential IP and, when a reCAPTCHA wall appears, solves it — so blocked attempts are retried rather than returned empty. If every attempt is blocked and nothing is scraped, the run fails honestly with a clear message instead of reporting an empty success.

MCP / AI agents

This actor is MCP-ready: a single narrow input (searchQueries + country) returns compact, flat JSON rows. Discover it as apify--mercadolibre-search-scraper.

FAQ

Does it return product detail pages? No — it returns search-result cards. Use the url/itemId to fetch details separately.

Why are some prices without a discount? The card simply isn't on promotion; originalPrice/discountPercent are omitted.

Can I scrape a filtered search? Yes — apply filters on MercadoLibre in your browser and paste the resulting URL into startUrls.

Why is reviewsCount often empty? MercadoLibre's compact search cards show the star rating but not always the review count.

Legal

This actor collects only publicly available data shown on MercadoLibre search pages. You are responsible for using the scraped data in compliance with MercadoLibre's Terms of Service, applicable laws (including data-protection and copyright law), and for not overloading the target site. It does not access private data or bypass authentication. Not affiliated with or endorsed by MercadoLibre / Mercado Livre.