Mercado Libre & Mercadolivre Reviews Scraper

🚀 Mercado Libre Reviews Scraper: Opiniones, Comentarios and Avaliações

Export Mercado Libre and Mercado Livre product reviews from Mexico, Argentina, Brazil, Colombia, Chile, Peru, Uruguay, Ecuador and Venezuela as clean JSON, CSV or Excel. The Mercado Libre Reviews Scraper turns product URLs into structured star ratings, review text (comentarios, opiniones, avaliações), exact dates, helpful votes, customer photos and videos. Use it for sentiment analysis, product research and review monitoring, or as a simple alternative to the Mercado Libre API for reviews.

🎯 Use Cases

• Mercado Libre reviews for sentiment analysis: feed thousands of structured comentarios into your sentiment model, dashboard or spreadsheet.
• Monitor new opiniones on your products: schedule a daily run, sort by newest and catch quality complaints as soon as buyers post them.
• Find recurring complaints in negative reviews: filter to 1-star or 2-star reviews of a competitor's product to see what buyers dislike.
• Compare competing products on Mercado Livre: collect avaliações for several products and compare ratings, praise and complaints side by side.
• Collect buyer photos and videos: gather real customer media for product research and creative inspiration.

✨ Features

• Review data as fields: review ID, star rating, text (plus the untranslated original when the site shows a translation), exact timestamp, displayed relative date, helpful votes, the country the review came from, and the product's average rating and rating count.
• Newest or most helpful first: collect the latest reviews or start with the ones buyers found most useful.
• Star filters: focus on negative feedback or pick any rating from one to five.
• Photos and videos: customer photo URLs, plus video, preview and thumbnail URLs with duration.
• Deeper collection: optionally explore additional rating and sort groups to discover more unique reviews.
• Deduplicated results: a review is saved and charged only once per run, even when it appears in several groups, product variants or input URLs.
• Incremental monitoring: stop at review IDs collected in a previous run.
• Run summary: advertised rating and comment counts, average rating and the stopping reason for every product.

🛠️ How It Works

1. Paste product URLs or IDs: catalog product URLs, seller-item URLs or bare IDs (MLM40287790) from Mexico, Argentina, Brazil, Colombia, Chile, Peru, Uruguay, Ecuador and Venezuela.
2. Set the review limit: choose the maximum number of reviews, the order and an optional star rating.
3. Run the scraper and download the results as JSON, CSV or Excel, or retrieve them through the Apify API.

URLs are processed in input order. maxItems applies to the entire run, so the first product can use the whole limit. Use separate tasks if you want equal per-product allowances.

⚙️ Input

Field	Default	What it does
Product URLs (productUrls)	Example product prefilled	Up to 1,000 catalog or seller-item URLs, or bare IDs, from mercadolibre.com.mx, .com.ar, mercadolivre.com.br, mercadolibre.com.co, .cl, .com.pe, .com.uy, .com.ec and .com.ve. startUrls ([{"url": ...}]) and urls are accepted too. An empty input runs the example product.
Maximum reviews (maxItems)	50	Global maximum of 1–100,000 unique reviews for the whole run. Available reviews may be fewer.
Review order (sort)	dateCreated	dateCreated = newest first, relevance = most helpful first.
Star rating (rating)	all	All ratings, or a string from "1" to "5".
Deeper collection (deepScan)	false	Explore additional rating and sort groups after the initial group. Does not guarantee a complete history.
Stop at known review IDs (stopAtReviewIds)	[]	Numeric review IDs as strings. Stops each product when a matching ID is reached, excluding that review. Requires newest-first order with deeper collection disabled.

{
  "productUrls": [
    "https://www.mercadolibre.com.mx/apple-iphone-16-256-gb-rosa/p/MLM40287790",
    "https://www.mercadolivre.com.br/apple-iphone-15-128-gb-azul/p/MLB27172667"
  ],
  "maxItems": 200,
  "sort": "dateCreated",
  "rating": "all",
  "deepScan": false
}

Supported URLs: catalog URLs such as https://www.mercadolibre.com.mx/p/MLM40287790 and seller-item (article) URLs such as https://articulo.mercadolibre.com.mx/MLM-2158714653-iphone-_JM are different input types. Use the original URL so the Actor can select the correct type. Review-page URLs and /up/ product links that carry an item ID are also accepted; seller-item review URLs must keep isItem=true. A bare ID with a dash (MLM-2158714653) is read as a seller item; without a dash the Actor tries the catalog product first, then the seller item. URLs without https:// work. Search URLs, store pages and meli.la short links can't be read: they are skipped with a note in the log and the run continues with the other URLs. If no URL is usable, the run ends with a status message and nothing is charged.

Deeper collection: the Actor starts with your selected order and rating. With all ratings selected, it then explores individual star groups and both sort orders. With a specific rating, it only explores that rating in both orders. Output is not globally date-ordered in this mode, and a low review limit can be filled before the additional groups are explored.

Monitoring: save recent review IDs and pass them in stopAtReviewIds on the next run. Mercado Libre can reorder or add reviews, so stopping at a known ID is a convenience rather than a guarantee of discovering every new review.

💰 Pricing

Pay only for the unique reviews you get. No monthly rental.

Event	Price	What you get
Review	$0.001 per review ($1.00 per 1,000)	One unique, saved review with all fields below
Actor start	$0.00005 per run	Charged once when the run starts

Examples: 50 reviews = $0.05005 · 1,000 reviews = $1.00005 · 10,000 reviews = $10.00005.

Duplicates, retries, empty responses and product summaries are never charged. Set maxItems and the run's maximum charge to control spending; when the maximum charge is reached, the Actor stops and keeps the reviews it already saved.

📊 Sample Output Data

A real row from a run on an iPhone 16 catalog product in Mexico (long media URLs trimmed):

{
  "reviewId": "3158229520",
  "rating": 5,
  "text": "100% sellado, nuevo y original.",
  "originalText": null,
  "dateText": "Ayer",
  "createdAt": "2026-09-26T04:55:27Z",
  "reviewSite": "MLM",
  "reviewCountry": "México",
  "reviewedCatalogProductId": "MLM40287796",
  "variant": null,
  "helpfulVotes": 0,
  "photos": [
    "https://http2.mlstatic.com/D_NQ_NP_691664-MLA116725169622_092026-F.jpg"
  ],
  "videos": [
    {
      "url": "https://video-vod-clips.mms.mlstatic.com/v1/video/hls/…/master.m3u8",
      "previewUrl": "https://video-static-clips.mms.mlstatic.com/…/preview_….mp4",
      "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_671503-MLA118276021399_092026-B.jpg",
      "durationMs": 9242
    }
  ],
  "inputProductUrl": "https://www.mercadolibre.com.mx/apple-iphone-16-256-gb-rosa/p/MLM40287790",
  "inputProductId": "MLM40287790",
  "inputType": "catalog",
  "marketplace": "MLM",
  "sourceSort": "dateCreated",
  "sourceRating": "all",
  "sourceOffset": 0,
  "productRating": 4.8,
  "productRatingCount": 7690,
  "scrapedAt": "2026-09-27T06:02:36.392Z"
}

reviewSite and reviewCountry say where the review was written, which can differ from the input marketplace: Mercado Libre groups reviews across countries and product variants, so a Mexican product can return reviews from Argentina, Colombia, Chile, Peru, Uruguay or Brazil. reviewedCatalogProductId is the exact product version that was reviewed (for example another color of the same phone). createdAt is the exact timestamp; dateText is the relative date the site shows ("Ayer", "Hace 2 semanas", "Há mais de 1 ano"). sourceSort, sourceRating and sourceOffset show which group and page the review came from.

Field	Meaning
reviewId, rating, text	Stable review identity, star rating and comment.
originalText	The untranslated comment when Mercado Libre shows a translation (for example a Brazilian review on a Mexican product); null otherwise.
createdAt, dateText	Exact timestamp, plus the site's displayed date.
reviewSite, reviewCountry	Where the review originated.
reviewedCatalogProductId, variant	Reviewed product version, and the variant the buyer bought (for example Cor: Branco · Tamanho: 39 BR). variant is filled on listings with variations (articulo. / produto. URLs) and is usually null on catalog /p/ pages, where each color or size is its own product.
helpfulVotes	Helpful-vote count.
photos, videos	Customer media references (url, previewUrl, thumbnail, durationMs for videos).
productRating, productRatingCount	The product's average rating and total ratings, as advertised.
inputProductUrl, inputProductId, inputType, marketplace	Input attribution.
sourceSort, sourceRating, sourceOffset, scrapedAt	Collection context and time.

Media files are not downloaded and their availability can change.

Run summary

Open the Run summary (RUN-SUMMARY record) for the advertised rating and comment counts, average rating, explored groups and the stopping reason for each product:

Status	Meaning
max_items_reached	Your global review limit was reached.
budget_reached	The run's maximum charge was reached.
known_review_reached	A supplied review ID was encountered.
source_limited	At least one collection reached the source safety limit; more reviews may exist.
available_streams_exhausted	All selected groups returned empty after retries. This is not proof of a complete history.
no_reviews_returned	No reviews were returned and product validity could not be established. This can include nonexistent products or listings without reviews.
partial / failed	A retrieval problem or request limit stopped processing. Saved reviews remain available.
timeout_reached	The run stopped about 30 seconds before its timeout. Resurrect the run to continue where it stopped.
not_started	An earlier product used the run's review, request or charging allowance.

The run's status message summarizes the outcome, for example Saved 120 reviews. 1 product has no reviews. Stopped at the max charge limit. There is a run-wide request allowance to bound low-yield work. The run is marked as failed only when every product failed with errors; when only some products fail, the run succeeds and the status message counts them. Products without reviews, source limits, the timeout guard and ordinary review or charging limits are reported without failing the run.

🔁 Schedule and Integrate

For review monitoring, run it once a day with newest-first order and a modest maxItems (for example 50–200 per product): each run captures the latest comentarios, and stopAtReviewIds lets you stop at reviews you already have. For a one-off sentiment study, a single run with deeper collection is usually enough.

Set up recurring runs in Apify Schedules. Send the results to Google Sheets, Zapier, Make, n8n or a webhook with Apify integrations, so new reviews land where your team already works.

🤖 Use with AI Agents (MCP)

This Actor works as a tool in Claude, ChatGPT, Cursor and other MCP clients through the Apify MCP server (https://mcp.apify.com). An agent can call it with:

{
  "productUrls": ["https://www.mercadolibre.com.mx/apple-iphone-16-256-gb-rosa/p/MLM40287790"],
  "maxItems": 30,
  "rating": "1"
}

❓ FAQ: Mercado Libre API and Reviews

Does Mercado Libre have an official API? Yes. Mercado Libre and Mercado Livre run a developer API aimed at sellers and integrators; it requires registering an application and authorizing it with a Mercado Libre account. This Actor needs no key, app or account, and returns the public review data a shopper sees on the product page, including photos, videos, helpful votes, country of origin and exact dates, without any rate-limit handling on your side.

How do I export comentarios or opiniones from a Mercado Libre product? Paste the product URL, set the maximum number of reviews and run the Actor. Download the dataset as CSV or Excel, or pull it through the Apify API.

Can I scrape avaliações from Mercado Livre Brazil? Yes. Paste mercadolivre.com.br product URLs. Reviews can come from several countries; text may be in Spanish or Portuguese, and Mercado Libre may show some comments automatically translated. text is what the site shows; when it is a translation, originalText holds the buyer's own words.

Do I need a Mercado Libre account? No.

Why do I get fewer reviews than the product page advertises? Ratings and written reviews are different totals: a product can show thousands of ratings but fewer comments. Each sort and rating group also has a source limit on depth. Deeper collection raises coverage, but this Actor does not guarantee every advertised review. The run summary shows the advertised counts and why each product stopped.

Why is a field empty? text is null when the buyer left only stars or media. photos and videos are empty arrays when the buyer added none. variant is null when the product has no variations, which is typical for catalog /p/ pages. Reviewer names and individual verified-purchase flags are not available.

Which countries are supported? Product URLs from Mexico, Argentina, Brazil, Colombia, Chile, Peru, Uruguay, Ecuador and Venezuela. Reviews returned for those products can originate from other Mercado Libre countries. Bolivia, Paraguay, Dominican Republic, Costa Rica, Panama and Central America don't serve catalog reviews.

🔗 Related Scrapers

• Mercado Libre Listings Scraper: find products by search or category first, then pass their URLs here for reviews.
• Mercado Libre Product Details Scraper: prices, stock, seller information, variations and specifications to pair with review data.
• Mercado Libre Questions Scraper: buyer questions and seller answers on the same products.
• AliExpress Reviews Scraper: customer reviews from AliExpress for cross-marketplace product research.