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: Regional IP rotation and full page rendering are handled automatically — sails through Mercado Libre's regional traffic gating and bot-challenge interstitial with zero proxy setup.
• 🧩 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, seller, or detail URLs to crawl directly. See Scraping a seller's catalogue.
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).
maxConcurrency	integer	no	Maximum pages fetched in parallel. Default 5.

🏪 Scraping a seller's catalogue

To pull every product from one seller, open their storefront in a browser and paste the URL straight into startUrls — no ID lookup needed. All storefront types work:

Seller type	URL you copy from the browser
Official store	https://www.mercadolibre.com.ar/tienda/apple
Seller storefront	https://www.mercadolibre.com.ar/pagina/SLUG
Regular seller	https://perfil.mercadolibre.com.ar/NICKNAME

The scraper paginates through the seller's whole catalogue the same way it does a keyword search, subject to maxItems and Mercado Libre's ~2,000-item browsing cap. Filters such as priceMin/priceMax and sort do not apply to seller URLs — they are part of the search query, not the storefront.

📊 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"
    }
]

📋 Output Fields

Two row shapes. A listing row is what a search page carries; an item row (includeProductDetail: true) opens the item page and adds the rest. The dataset has a view for each, so neither shows a column it cannot fill.

Field	Type	Listing	Item	Description
id	string	✅	✅	Mercado Libre item ID, e.g. MLA3195087256
siteId	string	✅	✅	Marketplace — MLA Argentina, MLB Brazil, MLM Mexico …
title	string	✅	✅	Product title
permalink	string	✅	✅	Link to the item (promoted items resolve via a click tracker)
price	number	✅	✅	Current price, in the marketplace's own currency
currency	string	✅	✅	ISO code — ARS, BRL, MXN … prices are not converted
originalPrice	number	✅	✅	Price before discount, when one is running
discountPercent	number	✅	✅	Discount off the original price
thumbnailUrl	string	✅	✅	Main product image
location	object	✅	✅	City, state, country the item ships from
seller	object	✅	✅	Nickname, official-store flag, reputation
freeShipping	boolean	✅	✅	Listing advertises free shipping
fullShipping	boolean	✅	✅	Ships via Mercado Envíos Full
isPromoted	boolean	✅	✅	Paid placement rather than organic
isFeatured	boolean	✅	✅	Featured by Mercado Libre
scrapedAt	string	✅	✅	ISO 8601 timestamp of the scrape
images	array	—	✅	Full image gallery
description	string	—	✅	Full item description
attributes	object	—	✅	Specification matrix from the item page
soldQuantity	number	—	✅	Units sold
ratingAverage	number	—	✅	Average review score
reviewCount	number	—	✅	Number of reviews
catalogProductId	string	—	✅	Catalogue entry the item belongs to

availableQuantity, condition, installments, shippingMode and variations are still emitted for backwards compatibility but are not currently populated — measured null across 38 rows on both MLA and MLB, in listing and detail mode. They are excluded from both views rather than shown as permanently empty columns.

💸 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.003	$3.00
item-detail	Each full product detail page (includeProductDetail: true) — adds description, full specs, variations, gallery, stock	$0.025	$25.00
Actor start	Once per run	$0.00005	—

There are no proxy or compute add-ons to manage — anti-bot handling is included in the per-event price. Set maxItems to cap your spend.

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