MercadoLibre Scraper — Products, Reviews, Q&A & Sellers

What is MercadoLibre Product and Seller Data Scraper?

Extract structured MercadoLibre and Mercado Livre listings across supported Latin American marketplaces. Search by keyword or process product, review, question, seller, and category URLs to receive prices, product attributes, seller signals, shipping details, reviews, and buyer Q&A.

Use the Actor for regional ecommerce research, assortment analysis, price monitoring, seller intelligence, catalog enrichment, and AI workflows that need consistent marketplace records.

Best fit

• Ecommerce teams comparing listings across Latin American marketplaces.
• Brands monitoring prices, verified store signals, sellers, and product attributes.
• Analysts organizing customer reviews and buyer questions around selected products.
• Catalog teams enriching product IDs and URLs with marketplace details.
• AI research agents that need explicit country and record provenance.

A practical market-research scenario

A regional analyst searches for smartphones in Mexico and collects listing cards with prices, condition, seller, shipping, and product URLs. Selected item IDs then move through product mode for pictures, attributes, variations, and seller details. Review and question modes add customer language and purchase considerations. The analyst can repeat the same workflow for Brazil or Argentina while preserving country, siteId, itemId, and source as stable join and provenance fields.

This creates one regional dataset while keeping each marketplace context visible.

Supported workflows

Mode	Input	Result
auto	Mixed URLs and itemIds	Detects the matching workflow for each target.
search	searchQuery or search URL	Listing cards with prices, sellers, shipping, and product links.
product	Product URL or item ID	Product attributes, variations, pictures, availability, and seller details.
reviews	Product URL or item ID	Individual customer review records.
questions	Product URL or item ID	The latest public buyer questions (up to about 40 per listing) with seller answers and answer dates.
seller	Seller profile URL or product URL	Seller ID, name, reputation level, MercadoLíder status, sales, product and follower counts, store type.
category	Category URL	Listings from the selected marketplace category.

Input and quick start

Search in Mexico

{
  "searchQuery": "wireless headphones",
  "country": "MX",
  "mode": "search",
  "maxResults": 25,
  "sortBy": "relevance"
}

Enrich a product

{
  "startUrls": [
    {
      "url": "https://articulo.mercadolibre.com.mx/MLM-1234567890-product"
    }
  ],
  "mode": "product",
  "extendedDetails": true
}

Use automatic routing for several markets

{
  "itemIds": ["MLA1234567890", "MLB987654321"],
  "startUrls": [
    { "url": "https://articulo.mercadolibre.com.mx/MLM-555444333-product" }
  ],
  "mode": "auto",
  "maxResults": 30
}

Buyer questions for a listing

{
  "startUrls": [
    {
      "url": "https://www.mercadolibre.com.mx/apple-iphone-15-128-gb-azul/p/MLM1027172667"
    }
  ],
  "mode": "questions",
  "maxResults": 40
}

Input reference

Field	Purpose
searchQuery	Keyword used for marketplace search.
startUrls	Product, search, category, or seller URLs.
itemIds	Raw item or catalog IDs such as MLM3116025461; the prefix picks the marketplace.
mode	Selects automatic routing or a focused extraction workflow.
country	Marketplace context for keyword searches.
maxResults	Upper bound for dataset records.
sortBy	Orders search and category listings.
condition	Focuses results on any, new, or used products.
minPrice, maxPrice	Applies a local-currency price range.
freeShipping	Focuses discovery on free-shipping listings.
officialStoreOnly	Focuses discovery on marketplace-verified stores.
minRating	Search and category: only listings rated at least this many stars (listings without a rating are left out).
minDiscount	Search and category: only listings at least this many percent below their previous price.
excludeKeywords	Search and category: leave out listings whose title contains any of these words.
countries	More marketplaces for the same search query, for example ["AR","CO"].
monitorMode	Deliver only listings that earlier runs with the same monitorStoreName did not deliver. See Monitor mode below.
extendedDetails	Enriches discovered listings from valid public product pages and hydration data. Fields that MercadoLibre does not expose publicly remain null with _warnings.
includeReviews	Adds review records when the selected flow supports them.
proxyConfiguration	Proxy for the backup browser route. The default pins each marketplace to residential IPs in its own country; explicit custom proxy settings take precedence.

The country field supports Mexico, Brazil, Argentina, Chile, Colombia, Peru, Uruguay, Ecuador, the Dominican Republic, Bolivia, Paraguay, Guatemala and El Salvador. URLs and item IDs can carry their own marketplace identity in automatic mode. Use countries to run one search on several marketplaces in a single run.

Monitor mode

Schedule the same input daily or hourly with monitorMode on. The first run delivers everything and saves a memory under monitorStoreName; later runs return only new listings (changeType: "new"). Add monitorPriceChanges to also get a known listing once when its price moves (priceDrop or priceIncrease, with previousPrice and priceChangePercent), and minPriceChangePercent to ignore small moves. Known listings are skipped and are not charged. Use one store name per schedule; sort by newest for the freshest results.

Output data

Records can include:

• mode, country, siteId, itemId, and canonical url
• title, price, originalPrice, currencyId, and discountPercent
• condition, soldQuantity, availableQuantity, and freeShipping
• pictures, attributes, variations, categoryId, and categoryPath
• sellerId, sellerName, and sellerReputation (level, MercadoLíder status, sales, products, followers, store type) from the product page's seller block
• review ratings, review text, reviewer names, and helpful-vote signals
• buyer questions (questionId, questionText) with seller answers (answerText, answerDate)
• source, dateScraped, and _warnings for provenance and record context

{
  "mode": "search",
  "country": "MX",
  "siteId": "MLM",
  "itemId": "MLM1234567890",
  "title": "Wireless Bluetooth Headphones",
  "price": 899,
  "currencyId": "MXN",
  "condition": "new",
  "freeShipping": true,
  "sellerName": "Example Store",
  "source": "html"
}

AI agent workflows

The explicit mode, country, and source fields make the Actor suitable for Apify MCP and direct API tool calls.

Example agent request:

Search MercadoLibre Mexico for wireless headphones, return prices, shipping, seller names, and product IDs, then enrich selected products with attributes and variations.

Useful routing guidance:

• Use search plus country for market discovery.
• Use auto when an upstream workflow supplies mixed MercadoLibre URLs or item IDs.
• Use product for rich catalog enrichment.
• Use reviews and questions for customer-language research.
• Use seller for marketplace seller context.
• Keep country, siteId, itemId, and source in downstream records.

Run through the API

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~mercadolibre-all-in-one-scraper/runs" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "searchQuery": "wireless headphones",
    "country": "MX",
    "mode": "search",
    "maxResults": 25
  }'

The Apify token stays in the Authorization header. Dataset records can be downloaded through Apify in JSON, CSV, Excel, and other supported formats.

Data sourcing and recovery

Every page goes through a route ladder:

1. Primary: a managed web-unblocking service fetches the public MercadoLibre page from the marketplace's own country. If MercadoLibre streams an empty shell or blocks the request, the page is fetched again in a rendered browser that waits for the listings or product to appear.
2. Backup: for search and category runs, canonical listing links recovered from public search indexes (capped at three seeds; these rows have source: "public-index" and fewer fields). As a short last resort for any page, our own headless Firefox on residential IPs pinned to the marketplace country.

Reviews come from a reviews data service first (up to 30 reviews per call, any marketplace), with MercadoLibre's own review feed as the fallback.

Every response is checked for verification and login walls before parsing, so a challenge page is never returned as data or reported as an empty result.

The run's OUTPUT record shows how many pages each route served (retrieval), so you can see when the backup route was needed.

Pricing

Startup billing and empty runs

The apify-actor-start event costs $0.00005 per startup unit. Apify charges one startup unit per GB of allocated memory, with a minimum of one unit, so a 2 GB run incurs two units. This startup charge still applies when input is invalid, no results are found, or an upstream request fails. Statements about free, unbilled, or skipped results refer only to the corresponding result event; they do not waive the startup charge. Apify platform usage is charged separately according to the run resources and your plan. Check the live Pricing tab for current events, tiers, and rates. Result limits cap result events, not the entire run cost.

This Actor uses Pay per event pricing with platform usage passed through. From 22 November 2026, search, category, review and question records use a separate, cheaper Listing result event with volume discounts on paid plans; product and seller detail records stay on the Detail result event. A result event is charged when a validated product, listing, review, question, seller, or category record is written. Treat the live Pricing tab as the current source of truth for event prices and billing details.

Use maxResults and focused modes to align the dataset with the regional research brief.

Known limits

• Questions: MercadoLibre's public questions page shows the latest answered questions, usually about 40 per listing. Older questions are not returned.
• Reviews: catalog products (/p/ URLs) and individual listings use different review IDs; the Actor tries both.
• Seller location is not shown on public pages and stays null.

Best results

• Select the marketplace country that matches the analysis.
• Use automatic mode for mixed URL collections and focused modes for deterministic workflows.
• Start with search records, then enrich selected product URLs or item IDs.
• Use country-aware residential routing for consistent marketplace context.
• Preserve provenance and marketplace identifiers when combining countries.

Builder's note

I designed this Actor around the way regional ecommerce research actually expands: begin with a country and keyword, preserve each marketplace identifier, then enrich only the products, sellers, reviews, or questions that matter. The shared dataset contract keeps those modes composable for analytics and AI agents.

Continue the workflow

• Then use MercadoLibre Search Scraper — Price, Seller & Rating to extend MercadoLibre Product and Seller Data Scraper research with a complementary discovery contract.
• Then use Myntra Product Scraper to extend MercadoLibre Product and Seller Data Scraper with a neighboring commerce research source when the brief calls for Myntra data.

Responsible use

This Actor collects publicly available marketplace information. Use the results for legitimate ecommerce research and automation in line with applicable laws, marketplace terms, privacy requirements, and your organization's data-governance policies.