Mercado Libre Scraper — LATAM Prices, Listings & Specs

Disclaimer: Unofficial integration, not affiliated with Mercado Libre or MercadoLibre, Inc. Mercado Libre and related trademarks belong to their respective owners. Data is read from publicly accessible search results and product pages. No account login required.

This Actor is provided for informational, research, and price monitoring purposes only. You are solely responsible for complying with applicable laws, Mercado Libre's terms of use, and your organization's policies.

Extract structured product listings and full specifications from Mercado Libre across 18 Latin American country sites — Argentina, Brazil, Mexico, Colombia, Chile, Peru, and more. Search by keyword, category URL, or direct product link. Collect titles, prices, discounts, installments, seller info, shipping badges, ratings, technical attributes, stock, sold quantity, and image galleries.

Built-in Akamai anti-bot bypass via Playwright browser automation and residential proxy rotation. No cookies, no account required.

Best for: Mercado Libre price monitoring, LATAM e-commerce market research, competitor catalog tracking, resale arbitrage, product specification enrichment, and bulk JSON/CSV export pipelines.

Crawloop Mercado Libre LATAM Suite — raw listing export and market intelligence across the same 18 country sites.

Mercado Libre Scraper ◄── you are here	Mercado Libre Market Intelligence
Raw listings, fast search, optional PDP	Niche score, demand, GMV, market reports

---

When to use this Actor

• Mercado Libre price tracking — Monitor listing prices, discounts, and installments across Argentina (MLA), Brazil (MLB), Mexico (MLM), Chile (MLC), Colombia (MCO), and 13 more LATAM sites.
• Product catalog enrichment — Enable includeProductDetail to fetch full PDP data: description, spec tables, stock, sold count, variations, and high-resolution images.
• Cross-border market research — Compare the same product keyword across multiple Mercado Libre country sites with local currency output.
• Official store monitoring — Filter to official stores only and track brand-authorized sellers.
• Category & filter scraping — Paste any filtered Mercado Libre search or category URL into Start URLs to replicate browser filters exactly.
• Bulk data pipelines — Export structured JSON or CSV datasets for spreadsheets, databases, and BI tools.

When not to use this Actor

• Private seller messaging or account actions — Reads public listing and search pages only; no login, cart, or messaging access.
• Real-time sub-second monitoring — Optimized for reliable bulk extraction, not millisecond-level price tick feeds.
• Non-Mercado Libre sites — Built specifically for Mercado Libre domains across LATAM; not a generic web scraper.
• Niche scoring & market reports — use Mercado Libre Market Intelligence — LATAM Niche & Demand Analyzer for opportunity score, demand, GMV, and Markdown reports.

---

Key Features

• 18 LATAM country sites — MLA, MLB, MLM, MCO, MLC, MPE, MLU, MLV, MEC, MBO, MPA, MPY, MRD, MCR, MNI, MGT, MHN, MSV with automatic country-targeted residential proxy.
• Two extraction modes — Fast search-card mode (title, price, seller, shipping) or full PDP enrichment (specs, description, stock, gallery, variations).
• Parallel PDP fetching — Multi-session proxy pool with configurable pdpConcurrency and automatic retry on anti-bot timeouts.
• Rich listing data — Original price, discount percent, installment plans, condition (new/used/refurbished), free shipping, FULL logistics badge, seller reputation, and ratings.
• Flexible inputs — Keyword search, category URLs, direct product URLs, price range filters, condition filters, sort order, and official-store-only mode.
• Structured dataset output — Clean JSON rows ready for Apify dataset export, webhooks, and integrations.

---

How it works

1. Creates a pool of Playwright browser contexts, each with an independent residential proxy session in the target country.
2. Navigates to the constructed search URL and waits for Akamai security checks to complete.
3. Parses search result cards — titles, prices, sellers, shipping, thumbnails, and product IDs.
4. When includeProductDetail is enabled, fetches each product detail page in parallel, parses specifications and description, then retries through an alternate proxy session on failure.
5. Pushes structured rows to the Apify dataset with pay-per-event billing per extracted item.

---

Supported country sites

Site ID	Country	Currency	Domain
MLA	Argentina	ARS	mercadolibre.com.ar
MLB	Brazil	BRL	mercadolivre.com.br
MLM	Mexico	MXN	mercadolibre.com.mx
MCO	Colombia	COP	mercadolibre.com.co
MLC	Chile	CLP	mercadolibre.cl
MPE	Peru	PEN	mercadolibre.com.pe
MLU	Uruguay	UYU	mercadolibre.com.uy
MLV	Venezuela	VES	mercadolibre.com.ve
MEC	Ecuador	USD	mercadolibre.com.ec
MBO	Bolivia	BOB	mercadolibre.com.bo
MPA	Panama	USD	mercadolibre.com.pa
MPY	Paraguay	PYG	mercadolibre.com.py
MRD	Dominican Republic	DOP	mercadolibre.com.do
MCR	Costa Rica	CRC	mercadolibre.co.cr
MNI	Nicaragua	NIO	mercadolibre.com.ni
MGT	Guatemala	GTQ	mercadolibre.com.gt
MHN	Honduras	HNL	mercadolibre.com.hn
MSV	El Salvador	USD	mercadolibre.com.sv

---

Input Parameters

Parameter	Type	Default	Description
siteId	String	MLA	Target country site code (see table above).
searchQueries	Array	["iphone"]	Keywords to search (one per line).
categoryUrls	Array	[]	Category or filtered search URLs to crawl.
startUrls	Array	[]	Mix of search, category, or direct product detail URLs.
priceMin	Integer	—	Minimum price filter in local currency.
priceMax	Integer	—	Maximum price filter in local currency.
condition	String	any	Filter: any, new, used, refurbished.
officialStoresOnly	Boolean	false	Restrict results to Mercado Libre official stores.
sort	String	relevance	Sort: relevance, price_asc, price_desc.
includeProductDetail	Boolean	false	Fetch full PDP: description, specs, stock, variations, gallery.
maxItems	Integer	100	Stop after N items (0 = unlimited).
maxPagesPerQuery	Integer	42	Maximum search pages per query (~48 items/page).
maxConcurrency	Integer	5	Parallel search/category crawl jobs.
pdpConcurrency	Integer	5	Parallel product detail page fetches (when PDP enabled).
sessionPoolSize	Integer	4	Independent residential proxy sessions (1–10).
proxyConfiguration	Object	auto	Apify proxy; residential proxy in target country auto-configured.

Input example — search listings

{
  "siteId": "MLA",
  "searchQueries": ["iphone 15"],
  "maxItems": 500,
  "condition": "new",
  "officialStoresOnly": false,
  "includeProductDetail": false,
  "sort": "price_asc"
}

Input example — full product details (PDP)

{
  "siteId": "MLB",
  "searchQueries": ["samsung galaxy s24"],
  "maxItems": 200,
  "includeProductDetail": true,
  "pdpConcurrency": 8,
  "sessionPoolSize": 4
}

---

Output Format

Each dataset row = one Mercado Libre product listing.

Field	Type	Description
id	String	Product ID (e.g. MLA1424728826, MLAU3921879606).
siteId	String	Country site code (MLA, MLB, MLM, etc.).
title	String	Product title.
permalink	String	Canonical product URL.
price	Number	Current selling price in local currency.
currency	String	Currency code (ARS, BRL, MXN, CLP, etc.).
originalPrice	Number	Price before discount.
discountPercent	Integer	Discount percentage.
installments	Object	Installment quantity, amount, and interest rate.
condition	String	new, used, or refurbished.
availableQuantity	Integer	Stock count (PDP mode).
soldQuantity	Integer	Historical sold count (PDP mode).
thumbnailUrl	String	Search card thumbnail.
images	Array	Full image gallery (PDP mode).
description	String	Product description text (PDP mode).
location	Object	Seller city, state, country (PDP mode).
seller	Object	Nickname, official store flag, store name, reputation.
freeShipping	Boolean	Free shipping badge.
fullShipping	Boolean	Mercado Libre FULL logistics delivery.
ratingAverage	Number	Star rating (0–5).
reviewCount	Integer	Total review count (PDP mode).
attributes	Object	Technical specifications key-value pairs (PDP mode).
variations	Array	Color, size, and other variants with IDs and URLs (PDP mode).
scrapedAt	String	Extraction timestamp (UTC ISO 8601).

Output example

{
  "id": "MLA1424728826",
  "siteId": "MLA",
  "title": "Apple iPhone 14 (128 GB) - Blanco Estelar",
  "permalink": "https://www.mercadolibre.com.ar/apple-iphone-14-128-gb-blanco-estelar/p/MLA19597568",
  "price": 1199999,
  "currency": "ARS",
  "originalPrice": 1499999,
  "discountPercent": 20,
  "installments": {
    "quantity": 12,
    "amount": 99999,
    "rate": 0
  },
  "condition": "new",
  "availableQuantity": 15,
  "soldQuantity": 1500,
  "seller": {
    "nickname": "Apple",
    "isOfficialStore": true,
    "storeName": "Apple",
    "reputation": "level_5"
  },
  "freeShipping": true,
  "fullShipping": true,
  "ratingAverage": 4.8,
  "attributes": {
    "Memoria interna": "128 GB",
    "Memoria RAM": "6 GB",
    "Modelo del procesador": "Apple A15 Bionic"
  },
  "scrapedAt": "2026-07-09T10:40:00Z"
}

---

Search mode vs. PDP mode

	Search listings	Product detail (PDP)
Input flag	includeProductDetail: false	includeProductDetail: true
Speed	~3 min per 1,000 items	~40 min per 1,000 items
Data depth	Title, price, seller, shipping, thumbnail	+ description, specs, stock, sold qty, gallery, variations
Best for	Price monitoring, bulk catalog scans	Specification matching, enrichment, inventory analysis

---

Use Cases

Use Case	What you get
LATAM price intelligence	Structured price datasets per keyword across Argentina, Brazil, Mexico, Chile, and more
Competitor monitoring	Track official store listings, discounts, and installment offers in your product niche
Catalog specification matching	Full technical attribute tables for ERP, PIM, and marketplace listing sync
Resale arbitrage	Compare new vs. refurbished prices and sold quantities to find margin opportunities
Cross-border research	Same keyword on MLA vs. MLB vs. MLM with local currency normalization
Data pipelines	JSON/CSV export or webhook integrations to Sheets, databases, and BI tools

---

FAQ

Which Mercado Libre countries are supported?

All 18 Mercado Libre regional sites: Argentina, Brazil, Mexico, Colombia, Chile, Peru, Uruguay, Venezuela, Ecuador, Bolivia, Panama, Paraguay, Dominican Republic, Costa Rica, Nicaragua, Guatemala, Honduras, and El Salvador. Set siteId to the corresponding code (e.g. MLA for Argentina, MLB for Brazil).

How does it bypass Mercado Libre's Akamai bot protection?

The Actor uses headless Chromium via Playwright with residential proxies targeted to the site's country. Multiple independent proxy sessions rotate requests to avoid rate limiting. Akamai JavaScript challenges are solved automatically in the browser context.

Do I need proxies?

Residential proxies in the target country are strongly recommended and auto-configured on Apify Cloud when proxy input is left empty. For PDP mode with high maxItems, increase sessionPoolSize (default 4) to spread load across more IP addresses.

What is the difference between search and PDP mode?

Search mode (includeProductDetail: false) extracts data from search result cards — fast and cost-efficient for price monitoring. PDP mode (includeProductDetail: true) visits each product page for full specifications, description, stock, sold quantity, image gallery, and variations.

Can I scrape specific categories or advanced filters?

Yes. Open Mercado Libre in your browser, apply filters (category, price range, condition, sort order), copy the URL from the address bar, and paste it into categoryUrls or startUrls. Price and condition filters can also be set directly in the Actor input.

Does it work with used and refurbished listings?

Yes. Set condition to used or refurbished, or leave it as any. The Actor correctly parses user-product listings (/up/MLAU... URLs) alongside catalog products (/p/MLA...).

Can I scrape 1,000+ listings in one run?

Yes. Set maxItems to your target (e.g. 1000). Search mode handles 1,000 items in approximately 3 minutes. PDP mode with pdpConcurrency: 8 and sessionPoolSize: 4 completes 1,000 enriched products in approximately 40 minutes.

Does it export to JSON / CSV?

Yes. Results are written to the Apify dataset. Download JSON, CSV, or Excel from the run, or connect webhooks and integrations.

How is this different from Mercado Libre Market Intelligence?

This Actor exports raw listing rows for catalogs, price feeds, and custom pipelines. Mercado Libre Market Intelligence — LATAM Niche & Demand Analyzer adds opportunity scoring, demand/GMV estimates, competition tables, and Markdown market reports on top of the same Mercado Libre data.

How is this different from a generic web scraper?

This Actor is purpose-built for Mercado Libre: correct URL construction per country, Akamai bypass, installment parsing, official store detection, FULL shipping badges, LATAM number formatting, and parallel PDP enrichment with proxy session pooling.

---

Also see: Mercado Libre Market Intelligence — LATAM Niche & Demand Analyzer — niche opportunity score, demand analysis, estimated GMV, top sellers/brands, and market reports from Mercado Libre search and category data.