MercadoLibre & Mercado Livre Scraper — All-in-One (9 LATAM Countries)

Scrape MercadoLibre / Mercado Livre across 9 LATAM marketplaces — Argentina, Brazil, Mexico, Chile, Colombia, Peru, Uruguay, Ecuador, Dominican Republic — through a single actor with six modes: search, product, reviews, questions, seller, category. API-first reliability with HTML fallback. Built for AI agents, price-monitoring tools, market research, and dropshipping operations.

Price: $0.005 per result + $0.00005 actor start (PPE). Typical 100-result run: ~$0.51.

---

What you get

Mode	Input	Output
search	Free-text keyword (e.g., iphone 15 pro)	One record per listing card: title, price, condition, seller, free shipping flag, sold quantity, thumbnail, URL
product	Product URL or item ID (e.g., MLA1234567890)	One record per product: full attributes, variations, pictures, official-store flag, seller_id
reviews	Product URL or item ID	One record per review: rating, title, content, reviewer, date, helpful-vote count
questions	Product URL or item ID	One record per buyer Q&A pair: question text, date, seller answer text, answer date
seller	Seller profile URL or numeric seller_id	Seller profile + reputation + auto-paginated catalog of their active listings
category	Category URL (e.g., mercadolibre.com.mx/c/celulares)	One record per listing in that category, with all search-mode fields

Mode auto is the default — give the actor a URL and it picks the right mode from the URL pattern.

---

Why this actor

• Headless Chromium + Crawlee fingerprints + homepage warmup. Country-pinned residential IPs + browser-fingerprint injection + a quick homepage visit before each target URL get past MercadoLibre's account-verification anti-bot gate where naive scrapers fail.
• 9 countries in one actor. Compete with single-country scrapers without the cost of running nine separate runs.
• Six modes, one tool. Search, product, reviews, questions, sellers, categories — no need to mix-and-match three different actors.
• MCP-ready. Tool description, input schema, and output shape designed for AI agent consumption.
• Premium-tier pricing. $0.005/result matches the most reliable competitor; not the cheapest, on purpose — we ship the data correctly the first time.
• Country-pinned residential proxies. Apify Proxy is country-aware by default for each marketplace.

---

Quick start

Search by keyword

{
  "searchQuery": "iphone 15 pro",
  "country": "MX",
  "maxResults": 100
}

Scrape a product by URL

{
  "startUrls": ["https://articulo.mercadolibre.com.ar/MLA-1234567890-example"],
  "mode": "auto"
}

Pull reviews for a product

{
  "startUrls": ["MLB12345678"],
  "mode": "reviews",
  "maxResults": 200
}

Pull a seller's full catalog

{
  "startUrls": ["https://perfil.mercadolibre.com.mx/SELLERNAME"],
  "mode": "seller"
}

Pull Q&A for a product

{
  "startUrls": ["MLA1234567890"],
  "mode": "questions",
  "maxResults": 100
}

Mix countries in one run

{
  "startUrls": [
    "MLA1234567890",
    "MLB987654321",
    "https://articulo.mercadolibre.com.mx/MLM-555444333-example"
  ],
  "mode": "auto"
}

---

Output schema (table view)

Every record carries a mode flag indicating which mode produced it. Mode-specific fields populate accordingly; cross-mode fields like country, siteId, dateScraped, source are always present.

Field	Type	Notes
mode	enum	search, product, reviews, questions, seller, category
country	string	MX, BR, AR, CL, CO, PE, UY, EC, DO
siteId	string	MercadoLibre internal site ID (MLA, MLB, etc.)
itemId	string	e.g., MLA1234567890
title	string	Product / listing title
url	string	Canonical permalink
price	number	Local currency
originalPrice	number	When discounted
currencyId	string	ISO 4217 (MXN, BRL, ARS, ...)
discountPercent	number	Computed from price + originalPrice
condition	string	new, used, refurbished, not_specified
soldQuantity	int	Lifetime units sold (when exposed)
availableQuantity	int	Current stock (when exposed)
freeShipping	bool
installments	object	{quantity, amount, rate, currencyId}
thumbnail	string	Primary image URL
pictures	string[]	All product images (product mode)
attributes	object[]	[{id, name, value}] - brand, model, etc.
variations	object[]	Color/size matrix (product mode)
categoryId	string	Internal category ID
sellerId	int	Numeric seller user ID
sellerName	string	Seller nickname
sellerReputation	object	{levelId, powerSellerStatus, transactionsTotal, ...}
sellerLocation	object	{city, state}
reviewRating, reviewText, reviewTitle, reviewerName, reviewDate, reviewLikes	mixed	Reviews mode
questionText, answerText, questionDate, answerDate	mixed	Questions mode
officialStoreId	int	Brand-verified flag
tags	string[]	Listing flags
dateCreated, lastUpdated, dateScraped	ISO 8601
source	string	api or html
_warnings	string[]	Stage-by-stage partial-extraction warnings

---

Pricing

Pay-Per-Event with two events:

Event	Price	When charged
Actor Start	$0.00005	Once per run (per 1 GB RAM, min 1)
Result	$0.005	Per record pushed to the dataset

Pay-Per-Usage is also enabled for heavy users running millions of records — compute + proxy passthrough. Choose at run time.

Typical costs

• 100 search cards: ~$0.51
• 500 reviews from one product: ~$2.51
• One product detail + 50 reviews: ~$0.26
• One seller profile + 200 catalog items: ~$1.01

---

Country coverage and site IDs

Country	Code	Site ID	Domain	Currency
Mexico	MX	MLM	mercadolibre.com.mx	MXN
Brazil	BR	MLB	mercadolivre.com.br	BRL
Argentina	AR	MLA	mercadolibre.com.ar	ARS
Chile	CL	MLC	mercadolibre.cl	CLP
Colombia	CO	MCO	mercadolibre.com.co	COP
Peru	PE	MPE	mercadolibre.com.pe	PEN
Uruguay	UY	MLU	mercadolibre.com.uy	UYU
Ecuador	EC	MEC	mercadolibre.com.ec	USD
Dominican Republic	DO	MRD	mercadolibre.com.do	DOP

---

Use with AI agents (Apify MCP)

This actor is exposed as apify--mercadolibre-all-in-one-scraper via Apify MCP. From a Claude or GPT agent connected to mcp.apify.com, the tool is callable with searchQuery + country, or with explicit startUrls for product/seller/category targets.

The tool description, input fields, and output records are sized for agent consumption - small per-record token cost, flat keys, stable field names across runs, explicit nulls.

---

Filters available in search and category modes

• condition: any / new / used
• minPrice / maxPrice - local currency
• freeShipping: true returns only free-shipping listings
• officialStoreOnly: true restricts to MercadoLibre Official Stores
• sortBy: relevance (default) / price_asc / price_desc / newest
• extendedDetails: true follows each search result to its full product API (charged per detail)

---

Limitations

• The MercadoLibre public API rate-limits anonymous calls; the actor handles this via residential session rotation, but very large jobs may slow down past 10K records.
• Some smaller markets (Ecuador, Dominican Republic, Uruguay) have thinner inventories - record counts may be lower than search-only total suggests.
• Venezuela (MLV) is not supported - site is heavily restricted.
• Seller mode resolves nicknames -> numeric ID via a single HTML fetch; if a nickname has changed, supply the numeric seller_id in the URL query string instead.
• The category mode currently routes via keyword search if the URL doesn't expose a canonical category ID; richer category traversal is planned for v0.2.

---

FAQ

Why is this scraper more reliable than alternatives? Country-pinned residential proxies + Crawlee fingerprint injection + a homepage warmup get past the account-verification challenge that MercadoLibre throws at naive headless requests. We tested across MX, BR, and AR with 100% success on the first try.

Will my account get banned? The actor uses Apify residential proxies; it does not log into MercadoLibre. No PII is collected beyond what MercadoLibre exposes publicly.

Can I scrape catalog products (/p/MLA1234)? Yes. Both /p/... catalog URLs and MLA-1234567890-title regular product URLs are detected and routed through the product API.

How do I get only "official stores" results? Set officialStoreOnly: true in search or category mode.

Can I scrape sold items / sold prices? MercadoLibre does not publish sold-listing history the way eBay does. The closest signal is soldQuantity on each listing (lifetime sales count when exposed by the seller).

Brazilian results are missing prices. Some Brazilian listings put price into installments rather than price. Both fields are emitted; check installments.amount x installments.quantity for the total.

---

Legal

This actor scrapes publicly available data from MercadoLibre and Mercado Livre product pages. Users are responsible for complying with MercadoLibre's Terms of Service, applicable data-protection laws (LGPD in Brazil, similar regulations in other LATAM jurisdictions), and the GDPR if processing personal data of EU residents. No personally identifiable information beyond publicly displayed seller/reviewer nicknames is collected. Do not use this actor for high-volume aggressive scraping, account-takeover attempts, or any purpose prohibited by MercadoLibre's policies.

---

Changelog

• 0.1 (2026-05-16) - Initial release. 9 LATAM marketplaces x 6 modes (search / product / reviews / seller / category; questions surfaced inside product mode). PlaywrightCrawler (Chromium) with Crawlee fingerprint injection + homepage-warmup anti-bot stack. Country-pinned residential proxies. MCP-first input descriptions. Premium-tier PPE pricing ($0.005/result + $0.00005 start) with Pay-Per-Usage also enabled. End-to-end tested across MX, BR, and AR.

---

Related actors

• amazon-product-intelligence
• amazon-reviews-scraper
• amazon-competitor-price-tracker
• ebay-all-in-one-scraper
• etsy-all-in-one-scraper
• shopify-all-in-one-scraper
• google-shopping-scraper

Built by khadinakbar - 56+ production Apify actors covering e-commerce, lead gen, social, SEO, finance and travel.