MercadoLibre Scraper

Scrape product data from MercadoLibre across Latin America — title, price, condition, rating, review count, seller and images. Search by keyword, paste a category listing URL, or a direct product URL. The actor solves MercadoLibre's proof-of-work bot gate for you and returns clean structured rows. Seven country sites, pay per result, no monthly fee.

How it works

✨ Why use this scraper?

• Beats the bot gate. MercadoLibre fronts search/listing pages with a JavaScript proof-of-work challenge; this actor solves it server-side (no browser) and retries across residential IPs until it gets through — you just get the data.
• 7 country sites in one actor. Mexico, Argentina, Brazil, Colombia, Chile, Uruguay and Peru — prices returned in each site's currency.
• Three ways in. Keyword search, category/listing URL, or direct product URL — mixed freely in one run, auto-classified per entry.
• Clean canonical URLs. Sponsored/ad cards are de-duplicated to their real /p/MLM… product URLs, not click-tracking links.
• Optional full detail. Turn on enrichDetail to add brand, rating, review count, condition and the image gallery from each product page.
• Pay per result. Billed per product row with a strict maxItems cap, so a run never collects (or charges) more than you set.

🎯 Use cases

You are…	Use it to…
Pricing / competitive intelligence	Track competitor prices and availability across LATAM marketplaces
Resellers & dropshippers	Source products, monitor prices and stock, sync catalogs
Market research	Measure assortment, pricing and ratings by country and category
Brand monitoring	Watch how your products are listed, priced and rated by third-party sellers
Deal / price monitors	Track price drops on specific products on a schedule

📥 Supported inputs

Input	Example	What you get
Search keyword (searchTerms)	iphone	Search results on the chosen country site
Category / listing URL	https://listado.mercadolibre.com.mx/celulares	Every product in that listing
Product URL	https://www.mercadolibre.com.mx/p/MLM123456	That single product
Country	MLM / MLA / MLB / MCO / MLC / MLU / MPE	Which site to search

Not supported: seller back-office data, checkout, or anything behind a MercadoLibre account login.

🔄 How it works

1. Classify — each entry is tagged as a keyword search, a category listing, or a product URL.
2. Fetch + solve — pages are fetched over HTTP with a real Chrome TLS fingerprint; when the proof-of-work gate appears, the actor solves sha256(nonce + r) and replays the solution cookies.
3. Paginate — listings walk _Desde_N pages until empty or maxItems.
4. Parse — product cards (and, with enrichDetail, each product page's JSON-LD) are mapped to one normalized row.
5. Push — one row per product to the dataset (JSON or CSV), de-duplicated by canonical URL.

⚙️ Input parameters

Field	Type	Description
searchTerms	array	Keywords to search on the selected country site.
startUrls	array	Listing URLs, product URLs, or bare keywords — auto-classified.
country	string	Country site: MLM (default), MLA, MLB, MCO, MLC, MLU, MPE.
enrichDetail	boolean	Fetch each product page for brand, rating, condition and images (slower). Default false.
maxReviews	integer	Also scrape up to N recent reviews per product (rating, text, date). 0 = off.
maxItems	integer	Hard cap on products collected (and billed). Default 1000.
maxConcurrency	integer	Parallel jobs (kept low — each request solves a challenge). Default 4.
proxy	object	Proxy configuration. Residential strongly recommended.

📊 Output overview

One row per product, identical shape across every country site and discovery mode. Search/category rows carry the essentials (title, price, currency, canonical URL, image); with enrichDetail each row is enriched from its product page (brand, condition, rating, review count, full images); with maxReviews each row also carries up to N recent individual reviews. Export as JSON or CSV.

📦 Output sample

A real row (search on MLM, enrichDetail on):

{
  "type": "product",
  "site": "MLM",
  "country": "com.mx",
  "productId": "MLM1018500844",
  "title": "Apple iPhone 13 128 GB Medianoche",
  "url": "https://www.mercadolibre.com.mx/p/MLM1018500844",
  "price": 12999,
  "currency": "MXN",
  "brand": "Apple",
  "available": true,
  "rating": 4.9,
  "reviewCount": 7945,
  "reviews": [
    { "rating": 4, "text": "Es original, llegó rápido y bien empacado.", "date": "Hace 8 meses" }
  ],
  "primaryImage": "https://http2.mlstatic.com/D_NQ_NP_2X_...-F.webp",
  "images": ["https://http2.mlstatic.com/D_NQ_NP_2X_...-F.webp"],
  "discoveryMode": "search",
  "sourceUrl": "https://listado.mercadolibre.com.mx/iphone",
  "scrapedAt": "2026-06-27T06:30:00.000Z"
}

🗂 Key output fields

Group	Fields
Identity	productId, title, url, site, country
Pricing	price, currency
Detail (with enrichDetail)	brand, condition, available, rating, reviewCount
Reviews (with maxReviews)	reviews[] — each rating, text, date
Media	primaryImage, images[]
Provenance	discoveryMode, sourceUrl, scrapedAt

❓ FAQ

Does it get past MercadoLibre's bot protection? Yes — listing and product pages are gated by a JavaScript proof-of-work challenge. The actor solves it server-side and retries across IPs, so you don't need a browser or a CAPTCHA solver.

Do I need a proxy? Yes — use residential (the default). MercadoLibre blocks datacenter IPs outright, and the gate is served unevenly across IPs, so the actor relies on residential rotation.

Which countries are supported? Mexico, Argentina, Brazil, Colombia, Chile, Uruguay and Peru. Set country to the matching site code.

How do I get brand, rating and condition? Enable enrichDetail. It fetches each product's page (one extra request per product) and reads its structured data.

Can I scrape individual reviews? Set maxReviews to N — each product then includes up to N recent reviews (rating, text, date). Works with or without enrichDetail. Reviews are billed per review grabbed.

Why are some fields null in search mode? Without enrichDetail, rows come from the fast listing cards (title, price, URL, image). Brand/rating/condition live on the product page.

💬 Support

Hit a country site or page layout that doesn't parse? Open an issue with the URL you tried — most fixes are quick.

🛠 Additional services

Need a custom field, scheduled price monitoring, or another MercadoLibre country/section? Reach out for a tailored build.

🔎 Explore more scrapers

Pairs well with other marketplace and DTC product scrapers for broader e-commerce coverage.

---

⚠️ Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by MercadoLibre, Inc. or any of its subsidiaries. All trademarks are the property of their respective owners.

The scraper accesses only publicly available product and listing pages — no authenticated endpoints, seller dashboards, or account data. Users are responsible for ensuring their use complies with MercadoLibre's Terms of Service, applicable data-protection law (LGPD, GDPR, CCPA, etc.), and any contractual obligations of their own organisation.

---

SEO Keywords

mercadolibre scraper, mercado libre scraper, mercadolivre scraper, mercadolibre api, scrape mercadolibre, mercadolibre product scraper, mercadolibre price scraper, mercadolibre mexico scraper, mercadolibre argentina scraper, mercadolibre brasil scraper, mercadolibre colombia scraper, latam ecommerce scraper, marketplace price monitoring, mercadolibre data extraction, apify mercadolibre, product listing scraper, competitor price tracker latam, mercadolibre seller data, ecommerce product scraper, mercadolibre json csv