How to Scrape Mercado Libre Product Listings (Step-by-Step Guide)

If you want to scrape Mercado Libre product listings across Latin America — for price monitoring, MAP enforcement, or LATAM market research — this guide walks you through the entire process. You will learn what data you can extract from Mercado Libre search and category pages, how to automate the collection across all 18 country sites, and how to turn raw product listings into actionable e-commerce intelligence for the Latin American market.

Why Scrape Mercado Libre Data?

Mercado Libre is Latin America's largest e-commerce marketplace and the dominant online retail platform across virtually every Spanish- and Portuguese-speaking country in the region. With localized sites in 18 countries — including Argentina (MLA), Brazil (MLB), Mexico (MLM), Colombia (MCO), and Chile (MLC) — it sets the reference price for tens of millions of SKUs across LATAM, from smartphones and appliances to fashion, auto parts, and everyday consumer goods.

What makes Mercado Libre uniquely valuable as a data source is the depth of structured information on every product page: list price and current price, a clean discount percentage, installment plans (the dominant payment method in LATAM), seller reputation, "Mercado Libre Full" shipping flags, official-store status, sold quantities, and rich attribute tables. For anyone tracking the LATAM e-commerce market — sellers, brands, market researchers, and price-comparison products — Mercado Libre is one of the highest-signal public datasets available anywhere in the region.

Businesses and researchers scrape Mercado Libre data for a range of purposes:

• Price monitoring — track pricing changes across a competitor's catalog or an entire category in ARS, BRL, MXN, COP, CLP, PEN, and other LATAM currencies
• Cross-country pricing analysis — compare the same SKU across MLA, MLB, MLM, and the other 15 country sites to spot pricing inefficiencies
• Installment-plan economics — analyze how installments (cuotas / parcelas) affect effective pricing, which is central to LATAM consumer purchase decisions
• MAP (minimum advertised price) enforcement — monitor whether marketplace sellers in each country are violating brand pricing policies
• Demand & sentiment signals — use sold-quantity and review-count data to identify trending products and emerging LATAM brands
• Official-store vs. third-party comparison — segment listings by isOfficialStore to distinguish brand-direct retail from marketplace resellers

Manually copying product details from Mercado Libre across 18 country sites is impractical. A single search can return thousands of products across dozens of pages, prices and exchange rates move constantly, and each country site has its own regional traffic gating. Automation is the only realistic approach.

What Data You Can Extract from Mercado Libre

The Mercado Libre Listings Scraper extracts structured product data from any search query, category URL, or direct listing URL across all 18 LATAM country sites. Here are the key fields available:

With includeProductDetail: true, each record additionally includes the full product description, the complete specifications table, the full high-resolution image gallery, every available variation, and live stock data — the same payload you would see by manually opening the product page.

Common Use Cases for Mercado Libre Data

Price Monitoring & Discount Tracking

Mercado Libre's pricing is unusually transparent — every listing carries both the original price and the current selling price, plus a clean discount percentage. Scraping these fields on a schedule lets you build a real-time view of how aggressively competitors discount, when flash sales kick in, and how prices move during events like Hot Sale (Argentina, Mexico) and Black Friday (Brazil).

Cross-Country Catalog Analysis

A single SKU can appear on multiple country sites at very different prices once you account for local taxes, import duties, and currency volatility. Scraping the same product across MLA, MLB, MLM, MCO, and the other LATAM sites surfaces pricing inefficiencies and arbitrage opportunities that are invisible from a single country view.

Installment (Cuotas / Parcelas) Economics

In most LATAM markets, the headline price matters less than the installment plan. Mercado Libre listings expose installments.quantity, installments.amount, and installments.rate as first-class fields — letting you analyze the real effective price a consumer pays, including interest-free promotions, which is central to consumer decision-making in Argentina, Brazil, and Mexico.

MAP Enforcement for LATAM Brands

If you are a brand selling on or off Mercado Libre, the scraper makes MAP enforcement straightforward: pull every listing for your products across the relevant country sites, check the current price against your floor, and flag the violating sellers. The seller.isOfficialStore flag makes it easy to distinguish brand-authorized retail from gray-market resellers.

Cross-Marketplace Comparison

Pair Mercado Libre data with Amazon Mexico or other LATAM marketplaces on the same SKUs to spot pricing gaps. Many sellers list slightly different bundles, warranty terms, or financing options on each platform — surfacing those differences is straightforward when the data is structured.

Challenges of Scraping Mercado Libre Manually

Before jumping into the tutorial, it is worth understanding why building your own Mercado Libre scraper is harder than it looks:

• Regional traffic gating — Mercado Libre routes traffic by country and IP geolocation. A request from the US to mercadolibre.com.ar can return a totally different page than the same request from Buenos Aires
• JavaScript proof-of-work challenges — Mercado Libre serves anti-bot interstitials that require running real JavaScript to pass. Plain HTTP scrapers get stuck on the challenge page
• 18 different site IDs — each country site has its own URL structure, currency, language (Spanish vs. Portuguese), and category taxonomy
• Listing vs. detail dichotomy — listing pages return ~50 fields per product card, but description, full specs, and variations only live on the detail page
• Heavy pagination caps — Mercado Libre's HTML browse caps queries at roughly 2,000 items. Crossing that line requires either splitting the query or hitting the detail-page workflow
• Installment-plan parsing — installments are rendered as natural-language phrases ("12 cuotas de $208.333,25 sin interés") that require structured parsing to be usable
• Anti-bot defenses — request fingerprinting, rate limits, and traffic-pattern detection require active session management and residential proxies in the correct LATAM country
• Maintenance burden — Mercado Libre updates its frontend across all 18 sites independently, breaking custom scrapers that are not actively maintained

For most use cases, a pre-built and maintained scraper that already handles all 18 sites is dramatically more practical than building one in-house.

Step-by-Step: How to Scrape Mercado Libre Product Listings

Here is how to scrape Mercado Libre product data using the Mercado Libre Listings Scraper on Apify.

Step 1 — Pick a Country / Site ID

Every run starts with a single siteId — the country code Mercado Libre uses internally. The supported sites are:

• MLA — Argentina
• MLB — Brazil
• MLM — Mexico
• MCO — Colombia
• MLC — Chile
• MPE — Peru
• MLU — Uruguay
• MLV — Venezuela
• MEC — Ecuador
• MBO — Bolivia
• MPA — Panama
• MPY — Paraguay
• MRD — Dominican Republic
• MCR — Costa Rica
• MNI — Nicaragua
• MGT — Guatemala
• MHN — Honduras
• MSV — El Salvador

To collect data across multiple countries, simply run the scraper once per siteId.

Step 2 — Choose Your Input Mode

The scraper supports three input modes, and you can mix and match them in a single run:

• Search queries — plain-text terms like iphone 15 or notebook gamer. Each becomes a paginated Mercado Libre search behind the scenes
• Category URLs — any Mercado Libre category listing URL for the chosen site
• Start URLs — a free-form mix of listing, category, or direct product/detail URLs to crawl directly

Most users start with broad search queries or a category URL to discover products, then re-scrape specific URLs later when they need full detail-mode data.

Step 3 — Configure the Scraper Input

Head to the Mercado Libre Listings Scraper on Apify and configure your run:

1. Set the siteId (e.g. MLA for Argentina)
2. Add your searchQueries, categoryUrls, or startUrls (at least one is required)
3. (Optional) Apply filters — priceMin, priceMax, condition (any / new / used), officialStoresOnly, and sort (relevance / price_asc / price_desc)
4. Toggle includeProductDetail:
   • Off (listing mode) — fast and cheap, returns 20+ fields per product from the listing pages
   • On (detail mode) — visits each product page for the full description, complete specifications, gallery, variations, and stock
5. Cap your run with maxItems (0 = unlimited) and maxPagesPerQuery (default 42, which matches Mercado Libre's ~2,000-item browse cap)
6. The proxyConfiguration requires RESIDENTIAL group + the correct LATAM country code — this is what makes the scraper sail through Mercado Libre's traffic gating

Example input:

{
  "siteId": "MLA",
  "searchQueries": ["iphone 15", "notebook gamer"],
  "categoryUrls": [],
  "startUrls": [],
  "priceMin": 0,
  "priceMax": 5000000,
  "condition": "new",
  "officialStoresOnly": false,
  "sort": "relevance",
  "includeProductDetail": false,
  "maxItems": 500,
  "maxPagesPerQuery": 42,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "AR"
  }
}

Step 4 — Run the Scraper

Once started, the scraper will:

• Drive a real Chromium browser via Playwright through Apify's residential proxies in the correct LATAM country
• Solve Mercado Libre's regional gating and JavaScript proof-of-work challenges automatically
• Walk pagination up to maxPagesPerQuery or until maxItems is reached
• Parse installment plans, attributes, location, seller, and shipping flags into structured fields
• Optionally fetch each product page when includeProductDetail: true and merge the extra fields into the record
• Stream everything into a clean, typed dataset

Step 5 — Export Your Results

When the scraper finishes, export your data in the format you need:

• JSON — ideal for developers building integrations or price-monitoring pipelines
• CSV / Excel — perfect for spreadsheet analysis or importing into BI tools
• XML / HTML / RSS — useful for feeds and reporting workflows
• API — access results programmatically via the Apify API for automated runs

Ready to try it? Run the Mercado Libre Listings Scraper on Apify and get your first dataset in minutes.

Example Output (Real Data Preview)

Here is what the actual output looks like in listing mode (includeProductDetail: false). Each product is returned as a structured JSON object:

{
  "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"
}

Key things to notice:

• Original price, current price, and discount as first-class data — price, originalPrice, and discountPercent are extracted as separate numeric fields, ready for analysis
• Installments parsed into structure — installments.quantity, installments.amount, and installments.rate are decomposed from the natural-language "12 cuotas de $208.333,25 sin interés" string into clean numbers
• Seller intelligence baked in — seller.isOfficialStore, seller.storeName, and the reputation fields let you segment listings by brand-direct vs. third-party reseller
• Shipping flags ready for filters — freeShipping and fullShipping (Mercado Libre Full) are boolean fields, perfect for downstream filtering
• Attributes as a key-value object — brand, Modelo, Capacidad, and other category-specific attributes are structured, not stuffed into the title
• Provenance fields — id, siteId, and scrapedAt make it easy to deduplicate, join across countries, and audit your dataset

With includeProductDetail: true, you additionally get the full description, the complete specifications table, the full high-resolution image gallery, every available variation, and live stock data — the same payload you would see by manually opening the product page.

Try the Mercado Libre Listings Scraper now — no coding required.

Automating Mercado Libre Data Collection

For ongoing competitive intelligence across LATAM, you do not want to run the scraper manually every time. The Apify platform supports full automation:

Scheduled Runs

Set up recurring scrapes on any schedule — hourly, daily, or weekly — independently per country site. Hourly runs work well during Hot Sale or Black Friday Brazil when prices move quickly; daily runs are sufficient for general catalog tracking across the 18 LATAM sites.

API Integration

Use the Apify API to trigger scraper runs programmatically and retrieve results. This lets you integrate Mercado Libre data into your existing systems:

• Feed listings into your LATAM price-monitoring dashboard
• Trigger alerts when a tracked SKU drops below a target price in any country
• Sync Mercado Libre catalog data into your BI warehouse, partitioned by siteId
• Connect to tools like Zapier, Make, or custom data pipelines

Node.js Example

For a complete working example showing how to call this scraper from Node.js, see the GitHub repository.

Webhooks

Configure webhooks to get notified when a scraper run completes. This is useful for event-driven workflows where you want to process new product data as soon as it lands — especially when fanning out one run per LATAM country.

Using Mercado Libre Data for Business Intelligence

The structured data from Mercado Libre unlocks a range of analytical use cases that are specific to the LATAM market.

Price Intelligence in Local Currency

Track price movements across competitors in each LATAM currency, identify the cadence of discounts, and quantify how often specific SKUs hit their list price vs. their floor. With both price and originalPrice returned as numeric fields, building a time-series view of discount intensity is trivial — and the siteId field makes cross-country normalization straightforward when you layer in exchange rates.

Installment-Adjusted Pricing

In Argentina, Brazil, and Mexico, the effective price a buyer pays is the installment plan, not the headline price. Many flagship products are listed at a higher sticker price but sold in 12 interest-free installments — making them substantially cheaper than equivalents on competitor platforms. Computing installments.quantity × installments.amount (and discounting by installments.rate) gives you the true LATAM-relevant price metric.

Official-Store Share by Category

Scrape every result in a Mercado Libre category and group by seller.isOfficialStore. The result is a clean map of which categories are dominated by brand-direct retail vs. third-party resellers — useful for distribution decisions, MAP risk assessment, and identifying categories where direct-to-consumer entry on the marketplace would be most effective.

Demand Signals via Sold Quantity

Unlike most marketplaces, Mercado Libre exposes a soldQuantity field directly on listings. Combined with reviewCount and ratingAverage, sold-quantity is one of the strongest demand signals on the Spanish- and Portuguese-speaking internet — and it is one of the few public metrics that translates directly into a unit-volume estimate.

Does Mercado Libre Provide an API?

Mercado Libre publishes a public Developers API, but it has serious limitations for catalog research:

What's Available

• The API is OAuth-authenticated and intended for sellers managing their own listings
• Public catalog endpoints exist (/sites/{siteId}/search) but are aggressively rate-limited
• Many of the fields visible on the public site — installments, sold quantity, official-store flags, variations — are either gated, inconsistent, or missing from the API response
• Cross-country queries require separate API calls per siteId

What the API Misses

The official API is built around the seller workflow, not the buyer-facing catalog. Fields central to e-commerce intelligence — full installment plans with interest rates, the as-rendered discount percentage, the seller reputation badges, and complete attribute tables — are routinely incomplete or absent. Detail-page enrichment for arbitrary SKUs is also gated by rate limits that make systematic catalog work impractical.

The Mercado Libre Listings Scraper gives you a practical alternative — structured catalog data from any search query, category URL, or direct product URL, on any of the 18 LATAM country sites, without OAuth, partner approval, or rate-limit gating.

Why Use a Mercado Libre Scraper Instead of Building One

Building a custom Mercado Libre scraper sounds straightforward until you actually start:

• Regional traffic gating across 18 country sites — each siteId requires the correct LATAM residential IP. Cross-country requests are routinely redirected, blocked, or served degraded HTML
• JavaScript proof-of-work challenges — Mercado Libre's anti-bot interstitial requires a real browser running real JavaScript. Plain HTTP scrapers can't get past it
• Installment parsing — the natural-language installment strings ("12 cuotas de $208.333,25 sin interés", "10x de R$ 299,99 sem juros") differ by country, language, and currency and require careful parsing
• Pagination caps — Mercado Libre limits browse to ~2,000 items per query. Working around the cap requires splitting the query intelligently, not just paginating harder
• Site-specific category taxonomies — every country site has its own category tree. There is no clean global taxonomy
• Anti-bot defenses — request fingerprinting, behavioral checks, and IP-based throttling require active session management and proper proxy rotation
• Frontend churn — Mercado Libre updates parts of its site continuously, and changes propagate across the 18 country sites at different times
• Opportunity cost — every hour spent fixing your scraper across 18 sites is an hour not spent on the LATAM market analysis the scraper exists to support

Unless you have very specific requirements that no existing tool can meet, a maintained scraper that already handles all 18 country sites lets you focus on insights instead of plumbing.

Pricing — Pay Only for Results

The Mercado Libre Listings Scraper uses Apify's Pay-Per-Event pricing model. You only pay for products that actually land in your dataset — failed pages and retries are free. Compute units and residential proxy bandwidth are included in the per-event price.

Quick cost estimates:

• 1,000 listing-only products → $1.00
• 1,000 enriched products → $10.00
• 500 listings + 500 enriched (mixed run) → $0.50 + $5.00 = $5.50

For most price-monitoring and catalog use cases, the listing-only mode already returns 20+ fields per product — including installments, official-store flag, sold quantity, and seller location — and is by far the better value. Detail mode is best reserved for products where you need the full description, complete specifications, the full image gallery, or live stock data. Set maxItems to cap your spend.

Try the Mercado Libre Listings Scraper

The Mercado Libre Listings Scraper extracts structured data from Mercado Libre product listings across all 18 LATAM country sites — product IDs, titles, prices, original prices, discount %, installments, condition, available and sold quantity, seller info, location, shipping flags, ratings, reviews, attributes, images, and variations. Toggle detail mode for the full description, specifications, gallery, variations, and stock.

What you get:

• All 18 LATAM Mercado Libre country sites supported via a single siteId parameter
• Structured JSON, CSV, Excel, HTML, XML, or RSS output ready for any downstream tool
• Three input modes — search queries, category URLs, and start URLs — mix and match in a single run
• Real Chromium + residential proxies that sail through regional gating and JavaScript proof-of-work challenges
• Installments parsed into structured quantity / amount / rate fields, not natural-language strings
• Filters and sorting built in — price range, condition, official-stores-only, sort by relevance or price
• Pay-Per-Event pricing: $1.00 / 1,000 listing rows, $10.00 / 1,000 enriched rows — compute and proxy included
• Scheduled runs and API access for ongoing LATAM intelligence
• No coding, no proxy management, no scraper maintenance

Start scraping Mercado Libre now — your first run takes less than 5 minutes to set up.

If you are building an e-commerce data pipeline, combine Mercado Libre data with other marketplace sources like Walmart for North American retail, Flipkart for India, AliExpress for cross-border retail, or 1688.com for the upstream factory-direct view.

Legal and Ethical Considerations

Web scraping occupies a well-established legal space, but responsible practice matters:

• Public data only — the Mercado Libre scraper extracts publicly visible product information that anyone can see by visiting any of the 18 LATAM Mercado Libre sites. No login or authentication is required
• Respect rate limits — the scraper makes requests at a reasonable pace and rotates residential sessions to avoid overloading Mercado Libre's regional infrastructure
• No misuse — use collected data for legitimate business purposes like price monitoring, catalog research, MAP enforcement, and competitive analysis. Do not use the data to create counterfeit listings or mislead buyers
• Compliance — if you operate in jurisdictions covered by LGPD (Brazil), LFPDPPP (Mexico), Argentina's Ley 25.326, or similar LATAM data-protection regimes, ensure your data handling complies with the relevant regulations. This primarily applies to how you store and process the data, not the collection itself

Mercado Libre product listings are public marketplace data — they are designed to be found by buyers. Scraping this data for catalog research and price intelligence is aligned with the platform's intended purpose.

Frequently Asked Questions

Is scraping Mercado Libre legal?

Scraping publicly available data from Mercado Libre is generally legal. Product listings are visible to anyone who visits any of the 18 LATAM Mercado Libre sites without logging in. You should always use the data responsibly, comply with applicable privacy regulations in each LATAM jurisdiction, and avoid overloading Mercado Libre's servers with excessive requests.

Does Mercado Libre provide a public API?

Mercado Libre publishes a Developers API focused on official sellers and registered applications. It requires OAuth, has rate limits, and is intended for sellers managing their own listings — not for cross-marketplace catalog research. A web scraper is the practical alternative for price monitoring, competitor tracking, and LATAM market research.

Which Mercado Libre country sites are supported?

All 18 LATAM country sites are supported via siteId: MLA (Argentina), MLB (Brazil), MLM (Mexico), MCO (Colombia), MLC (Chile), MPE (Peru), MLU (Uruguay), MLV (Venezuela), MEC (Ecuador), MBO (Bolivia), MPA (Panama), MPY (Paraguay), MRD (Dominican Republic), MCR (Costa Rica), MNI (Nicaragua), MGT (Guatemala), MHN (Honduras), and MSV (El Salvador).

What data can be extracted from Mercado Libre?

You can extract product titles, current price, original price, discount percent, installments, condition, available and sold quantity, seller info (nickname, official store status), location, free/full shipping flags, ratings, review counts, attributes, images, and variations. With includeProductDetail enabled, you also get the full description, complete specifications, full image gallery, variations, and stock.

How do I use the Mercado Libre Scraper?

Pick a country (siteId), then provide search keywords, Mercado Libre category URLs, or direct listing/product URLs — or any combination. The scraper handles regional traffic gating, JavaScript proof-of-work challenges, pagination, and dataset assembly automatically. Results are exported as JSON, CSV, Excel, HTML, or via the Apify API.

How much does the Mercado Libre Listings Scraper cost?

The actor uses Apify's Pay-Per-Event pricing. Listing-only products cost $0.001 each ($1.00 per 1,000), and detail-enriched products cost $0.010 each ($10.00 per 1,000). Compute units and residential proxy bandwidth are included in the per-event price. You only pay for products that actually land in your dataset.

About the Author

This guide was written by Piotr, a software engineer with hands-on experience building and maintaining web scrapers at scale. He develops and maintains a suite of data extraction tools on the Apify platform, helping businesses automate their data collection workflows.