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, seller storefront, or direct product link. Collect titles, prices, discounts, installments, seller info, shipping badges, ratings, sold counts, catalog IDs, technical attributes, stock, and image galleries.

For detailed inputs, output fields, API examples, MCP prompts, pricing notes, and limitations, see the Mercado Libre Scraper API documentation by Crawloop.

Built-in Akamai / residential-proxy bypass via Playwright. Search starts from the Mercado Libre homepage (more stable than a cold listado hit). If a captcha or login wall appears, the Actor waits for the challenge, rotates the residential session, then falls back to Ofertas hubs. Optional session cookies from a logged-in browser still help on stubborn walls.

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, or paste a /tienda/, /loja/, /pagina/, or _CustId_ URL to dump that seller's catalog.
• 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, coupons, condition (new/used/refurbished), free shipping, FULL logistics badge, catalog product ID, seller reputation, sold counts, and ratings.
• Flexible inputs — Keyword search, category URLs, seller storefronts, direct product URLs, price range filters, condition filters, sort (relevance / price / most sold / newest), 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, and warms the Mercado Libre homepage on every session.
2. Submits the keyword through the homepage search box (same path a shopper uses), then paginates results. Direct listado URLs, /jm/search, and Ofertas hubs are fallbacks when a captcha or login wall appears.
3. Parses search result cards — titles, prices, sellers, shipping, thumbnails, and product IDs — including listings embedded in page JSON when CSS cards are empty.
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, seller storefront, or direct product detail URLs.
sellerUrls	Array	[]	Official stores (/tienda/, /loja/), independent shops (/pagina/), profiles, or _CustId_ catalogs.
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, sold_desc, newest.
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	2	Parallel search/category crawl jobs. Keep low to reduce captcha walls.
pdpConcurrency	Integer	5	Parallel product detail page fetches (when PDP enabled).
sessionPoolSize	Integer	4	Independent residential proxy sessions (1–10).
cookies / sessionCookies	Array / String	—	Optional logged-in Mercado Libre cookies when search hits a login or captcha wall.
blockAdsTrackers	Boolean	false	Block tracker domains. Leave off unless you are debugging bandwidth.
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 — official store catalog

{
  "siteId": "MLA",
  "sellerUrls": ["https://www.mercadolibre.com.ar/tienda/samsung"],
  "maxItems": 200,
  "includeProductDetail": false
}

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	Listing ID from wid when present (e.g. MLA1787211113).
catalogProductId	String	Catalog / user-product ID from /p/ or /up/ (e.g. MLA55887294).
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.
coupon	String	Visible Mercado Pago / coupon rebate on the search card.
condition	String	new, used, or refurbished.
availableQuantity	Integer	Stock count (PDP mode).
soldQuantity	Integer	Historical sold count from the search card or PDP.
thumbnailUrl	String	Search card thumbnail.
images	Array	Full image gallery (PDP mode).
description	String	Product description text (PDP mode).
gtin	String	GTIN / EAN from PDP JSON-LD or the specs table.
location	Object	Seller city, state, country (PDP mode).
seller	Object	Id, 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 when shown on the card or PDP.
isFeatured	Boolean	Oferta del día / deal badge on the search card.
position	Integer	1-based position on the search or offers page.
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, sold count, catalog ID, thumbnail	+ description, specs, stock, gallery, variations, GTIN
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

---

Integration examples

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/mercado-libre-listings-scraper').call({ siteId: 'MLA', searchQueries: ['iphone 15'], maxItems: 50, includeProductDetail: false });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.slice(0, 5));

Python

from apify_client import ApifyClient

client = ApifyClient(token)
run = client.actor("crawloop/mercado-libre-listings-scraper").call(
    run_input={"siteId": "MLA", "searchQueries": ["iphone 15"], "maxItems": 50, "includeProductDetail": False}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("id"), item.get("title"), item.get("price"))

cURL

curl "https://api.apify.com/v2/acts/crawloop~mercado-libre-listings-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"siteId":"MLA","searchQueries":["iphone 15"],"maxItems":50,"includeProductDetail":false}'

MCP and AI assistants

Use this Actor from AI tools via Apify MCP. Connect your Apify account, then call crawloop/mercado-libre-listings-scraper.

Example prompts:

• "Dump the Samsung official store on Mercado Libre Argentina"
• "Run Mercado Libre Listings Scraper for iphone 15 on MLA, max 50, return id, title, price, currency"
• "Scrape Mercado Libre Mexico for air fryers without PDP detail"
• "Chain Mercado Libre Listings then Market Intelligence for niche scoring"

Suite next step

For niche scores and GMV estimates, use Mercado Libre Market Intelligence.

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. Every proxy session is warmed on the Mercado Libre homepage first, then search goes through the on-site search box. Captcha and login walls trigger a wait + IP rotation, then Ofertas fallbacks. Akamai JavaScript challenges run in the browser; do not enable aggressive ad blocking if you hit captchas.

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 a seller storefront or official store?

Yes. Paste the store URL into sellerUrls or startUrls: official stores (/tienda/ or Brazil /loja/), independent shops (/pagina/), seller profiles, or listado _CustId_ catalogs. Pagination follows the on-page "Siguiente" link when it exists.

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.