🛒 MercadoLibre Product & Price Scraper: 18 LATAM Countries

🚀 MercadoLibre Product & Price Scraper is an Apify Actor that searches MercadoLibre and returns structured product data in seconds: price, discount, shipping, official-store status, and ratings across Argentina, Mexico, Brazil and 15 more LATAM countries.

🕒 Last updated: 2026-08-28 · 📊 26+ fields per record · 15 of 18 countries individually cloud-verified · by PunkRecordsData

MercadoLibre is the largest marketplace in Latin America, but every country runs on its own domain and its search pages actively block plain scrapers. This Actor drives a real stealth browser through a residential proxy matched to the country you pick, so you get real prices and real listings, not a bot-check page.

📚 Table of Contents

• 🎯 Who this is for
• 📋 What it does
• 🌎 Countries covered
• ⚙️ Input
• 📊 Output
• 🧾 Sample records
• 🚀 How to use
• 💼 Business use cases
• 🔌 Integrate with any app
• 💰 Cost
• ❓ FAQ
• 🗺️ Roadmap

🎯 Who this is for

🎯 Target Audience	💡 Primary Use Cases
📊 Price intelligence / analysts	Competitor price tracking across LATAM
🛍️ E-commerce & brand teams	Monitoring resellers, official-store compliance
📈 Market researchers	Category and demand analysis per country
🧾 Procurement teams	Sourcing and price comparison

📋 What the MercadoLibre Scraper does

• 🔍 Searches by keyword on any of the 18 supported countries
• 💵 Returns price, original price, discount %, and installments
• 🚚 Flags free shipping and captures the shipping note
• 🏪 Detects official store listings (vs. third-party sellers)
• ⭐ Captures the star rating shown on the search card
• 🗓️ Optional price, condition and free-shipping filters
• 📄 Optional full product detail enrichment. Description, brand, sold count, image gallery. One extra page visit per listing

🌎 Countries covered

15 of 18 confirmed working with live cloud runs (real listings, real prices):

✅ Working	✅ Working	✅ Working
🇦🇷 Argentina	🇪🇨 Ecuador	🇸🇻 El Salvador
🇲🇽 Mexico	🇧🇴 Bolivia	🇵🇦 Panama
🇨🇴 Colombia	🇵🇾 Paraguay	🇩🇴 Dominican Republic
🇨🇱 Chile	🇬🇹 Guatemala
🇵🇪 Peru	🇳🇮 Nicaragua
🇺🇾 Uruguay
🇻🇪 Venezuela

⚠️ Not currently working: 🇧🇷 Brazil, 🇨🇷 Costa Rica, 🇭🇳 Honduras. The residential proxy connection is refused for these three countries on repeated, isolated tests (not a code or site-blocking issue; confirmed via NS_ERROR_PROXY_CONNECTION_REFUSED, most likely an account/proxy-pool allocation gap for those specific countries). The other 15 use the exact same code path and work reliably.

⚙️ Input

Field	Type	Default	Description
searchTerms	array	None	Keywords to search, e.g. iphone 15
country	string	AR	Which MercadoLibre site to search, proxy is auto-matched
maxListings	integer	20	Listings to collect per search term. Free plan: capped at 10
condition	string	any	any / new / used
priceMin / priceMax	integer	None	Filter by price (local currency)
freeShipping	boolean	false	Only free-shipping listings
sort	string	relevance	relevance / price_asc / price_desc
withDetails	boolean	false	Visit each product page for description, brand, sold count, gallery
proxyConfiguration	object	RESIDENTIAL	Required, the Actor matches it to country automatically

{
  "searchTerms": ["iphone 15"],
  "country": "AR",
  "maxListings": 40
}

{
  "searchTerms": ["zapatillas running"],
  "country": "MX",
  "maxListings": 20,
  "freeShipping": true,
  "withDetails": true
}

⚠️ Good to know: filters are applied after collecting results, so a strict priceMin/priceMax/freeShipping combination may return fewer items than maxListings for a given search term. That's expected, not a bug.

📊 Output

Field	Description
🖼 imageUrl	Product image
🆔 id	MercadoLibre listing ID (e.g. MLA1027172677)
📌 title	Listing title
🔗 url	Canonical listing URL
💵 price / originalPrice / discountPercentage	Current price, pre-discount price, discount %
💱 currency	ISO currency for the selected country
💳 installmentsText	Raw installment-plan text as shown on the site
🚚 freeShipping / shippingText	Free-shipping flag + raw shipping note
🏪 officialStore / officialStoreName	Official-store flag + badge text
🎯 promoLabel	Any other promo badge on the listing (e.g. "Last one!")
👤 sellerName	Seller/brand name, when shown
⭐ ratingAverage	Star rating shown on the card
📢 isSponsored	Whether the listing is a paid/sponsored result
🔢 position	Rank within this search
🔍 searchQuery / 🌎 country	Which search produced this record
📝 description / brand / soldText / images	Only when withDetails is on
🕒 scrapedAt	When this record was scraped
❌ error	Present only on failed items

Download the dataset as JSON, CSV, Excel, or XML from the Apify Console, or pull it via the API.

🧾 Sample records (real data)

🚀 How to use

1. Sign up or log in at console.apify.com
2. Open MercadoLibre Scraper and go to the Input tab
3. Add a keyword to searchTerms and pick a country
4. Set maxListings and click ▶️ Start
5. Download results as JSON, CSV, Excel, or XML. Or pull them via the API

💼 Business use cases

📊 Competitor price tracking	🏪 Official-store compliance
Search your category across countries weekly, export to your BI tool, and spot who's undercutting on price.	Use officialStore to see who's selling as an authorized reseller vs. a third party, flag unauthorized listings.

🌎 Cross-country market research	🎯 Deal & discount monitoring
Compare pricing for the same product across Argentina, Mexico, Brazil and more to find your best-margin market.	Filter by discountPercentage and promoLabel to catch flash sales and low-stock urgency listings.

🔌 Integrate with any app

Pull results via the Apify API, or connect to Make, Zapier, Google Sheets, Airbyte, n8n, or any webhook-based tool from the Apify Console Integrations tab. Schedule recurring runs with Apify's built-in Scheduler.

curl "https://api.apify.com/v2/acts/PunkRecordsData~mercadolibre-scraper/run-sync-get-dataset-items?token=<YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "searchTerms": ["iphone 15"], "country": "AR", "maxListings": 20 }'

💰 Cost

Plan	What you get
🆓 Free	Up to 10 items per run (preview)
💳 Paid	Up to 1,000,000 items per run, billed on Apify usage (compute + residential proxy)

Cost is dominated by one page visit per search term, not by how many items you keep. A single search page typically returns 40+ listings. Setting maxListings closer to that natural page size (instead of many separate low-maxListings searches) gives the best cost per item. withDetails adds one extra page visit per listing and costs meaningfully more. Enable it only when you need the extra fields.

❓ Frequently Asked Questions

Does this work without a proxy? No. MercadoLibre blocks plain scrapers and even generic proxies on search pages. RESIDENTIAL, matched to the target country, is required.

Why did a search return 0 items? The site's anti-bot defenses are occasionally inconsistent. Retry the run. If it persists for a specific country, open an issue.

Can I filter by price or shipping? Yes: priceMin, priceMax, condition, freeShipping. These are applied after collection, so a strict filter can return fewer than maxListings items.

Does it download product images? It returns image URLs, not the files themselves.

Is this affiliated with MercadoLibre? No. See disclaimer below.

Can I run this on a schedule? Yes, use Apify's built-in Scheduler.

What happens on the free plan? Results are capped at 10 items per run.

🗺️ Roadmap

• 🔎 Category and seller-ID direct filtering
• 🔗 Raw start-URL passthrough (search / category / seller pages)
• 🤖 AI-generated listing summaries
• 💬 Reviews content (not just the star rating)

---

⚠️ Disclaimer: This is an independent tool, not affiliated with, endorsed by, or sponsored by MercadoLibre. It only collects data that is publicly visible on MercadoLibre's website.

🆘 Need help or want a custom scraper? Contact PunkRecordsData at contact.punkrecordsdata@gmail.com.