Mercado Libre Listings Scraper

🚀 Mercado Libre Listings Scraper

Easily extract product listings from Mercado Libre across all 18 LATAM country sites. The Mercado Libre Listings Scraper gathers structured product data from Latin America's largest e-commerce marketplace for price monitoring, market research, and catalog enrichment.

✨ Features

• 🌎 All 18 LATAM Sites: Argentina (MLA), Brazil (MLB), Mexico (MLM), Colombia, Chile, Peru, Uruguay, Venezuela, Ecuador, Bolivia, Panama, Paraguay, Dominican Republic, Costa Rica, Nicaragua, Guatemala, Honduras, and El Salvador.
• 🏷️ Comprehensive Product Data: Title, price, original price, discount, installments, condition, seller, location, shipping, ratings, reviews, attributes, images, and variations.
• 🔍 Flexible Inputs: Drive the scraper by search keywords, category URLs, or direct listing/detail URLs.
• 🛡️ Anti-Bot Built-In: Drives a real Chromium browser via Playwright + Apify residential proxies — sails through Mercado Libre's regional traffic gating and JavaScript proof-of-work challenges automatically.
• 🧩 Optional Detail Enrichment: Toggle includeProductDetail to fetch each item's full detail page for description, full specs, gallery images, variations, and stock.
• ⚙️ Filters & Sorting: Price range, condition (new/used), official stores only, and sort by relevance / price ascending / descending.

🛠️ How It Works

1. Pick a Country / Site ID – e.g. MLA for Argentina, MLB for Brazil, MLM for Mexico.
2. Enter Search Keywords, Category URLs, or Start URLs – mix and match as needed.
3. (Optional) Apply Filters – set price range, condition, official-stores-only, sort order, and toggle includeProductDetail.
4. Run the Scraper – results stream into the dataset and can be downloaded as JSON, CSV, Excel, or HTML.

📥 Input

Field	Type	Required	Description
siteId	string	yes	Country code: MLA, MLB, MLM, MCO, MLC, MPE, MLU, MLV, MEC, MBO, MPA, MPY, MRD, MCR, MNI, MGT, MHN, MSV.
searchQueries	array	no	Free-text keywords. Each becomes a paginated listing crawl.
categoryUrls	array	no	Mercado Libre category listing URLs.
startUrls	array	no	Mix of listing, category, or detail URLs to crawl directly.
priceMin	integer	no	Lower bound of the price filter (in site's local currency).
priceMax	integer	no	Upper bound of the price filter (in site's local currency).
condition	string	no	any, new, or used. Defaults to any.
officialStoresOnly	boolean	no	Restrict to Mercado Libre official-store sellers.
sort	string	no	relevance, price_asc, or price_desc. Defaults to relevance.
includeProductDetail	boolean	no	Fetch each item's detail page for description, full specs, variations, gallery images, and stock.
maxItems	integer	no	Stop after N items (0 = unlimited).
maxPagesPerQuery	integer	no	Pagination cap per query. Default 42 (Mercado Libre limits HTML browsing to ~2,000 items per query).
proxyConfiguration	object	yes	RESIDENTIAL group + LATAM country code. Required to bypass the suspicious-traffic interstitial.

📊 Sample Output Data

The scraper provides structured JSON output with full product details. Example:

[
    {
        "id": "MLA1424728826",
        "siteId": "MLA",
        "title": "Apple iPhone 15 Pro 256 Gb Titanio Natural - Distribuidor Autorizado",
        "permalink": "https://articulo.mercadolibre.com.ar/MLA-1424728826-apple-iphone-15-pro-256-gb-_JM",
        "price": 2499999,
        "currency": "ARS",
        "originalPrice": 2799999,
        "discountPercent": 11,
        "installments": { "quantity": 12, "amount": 208333.25, "rate": 0 },
        "condition": "new",
        "availableQuantity": 5,
        "soldQuantity": 250,
        "thumbnailUrl": "https://http2.mlstatic.com/D_NQ_NP_2X_...-F.webp",
        "images": ["https://http2.mlstatic.com/..."],
        "location": { "city": "Capital Federal", "state": "Buenos Aires", "country": "Argentina" },
        "seller": {
            "nickname": "VENDEDORX",
            "isOfficialStore": true,
            "storeName": "VENDEDORX",
            "reputation": null,
            "powerSellerStatus": null
        },
        "freeShipping": true,
        "fullShipping": true,
        "ratingAverage": 4.8,
        "reviewCount": 742,
        "attributes": { "brand": "Apple", "Modelo": "iPhone 15 Pro", "Capacidad": "256 GB" },
        "variations": [],
        "scrapedAt": "2026-05-10T12:00:00.000Z"
    }
]

💸 Pricing

This Actor uses Apify pay-per-event pricing — you only pay for results you actually get.

Event	When charged	Price per result	Per 1,000 results
product-listing	Each product card scraped from a listing page (includeProductDetail: false)	$0.001	$1.00
item-detail	Each full product detail page (includeProductDetail: true) — adds description, full specs, variations, gallery, stock	$0.010	$10.00

Compute units and proxy bandwidth are included in the per-event price. Set maxItems to cap your spend.

Optimize your LATAM market research with Mercado Libre Listings Scraper today! 🚀