This tutorial shows how to scrape MercadoLibre reviews from product URLs into CSV with the MercadoLibre Review Scraper template for UScraper. You will import the workflow, replace the sample item URL, confirm the export path, validate the first rows, and handle the common issues that make MercadoLibre review exports return partial data.
Before you start
Prerequisites and guardrails
You need UScraper installed as a local desktop app, one or more MercadoLibre product URLs with reviews you are allowed to analyze, and a folder where the CSV can be written. Start with one product URL so the first run can validate access, fields, and export behavior.
This guide is for supervised research from pages and public responses you can inspect in a normal browser session. It is not a guide to bypass CAPTCHA, sign-in walls, verification screens, private seller areas, checkout flows, or account-only data. MercadoLibre also maintains official developer docs for API basics, product reviews, and items and searches. If your use case needs a sanctioned integration, seller account data, or production API governance, review those docs first.
Being able to load a page is not the same as having permission to automate, store, redistribute, or resell the data. Keep runs modest and document why each URL is in the dataset.
Workflow anatomy
How the MercadoLibre review scraper works
The JSON workflow is the source of truth. Its practical path is:
Navigate -> Wait for Page Load -> Element Exists
-> optional Click -> Sleep -> Inject JavaScript
-> Wait for Element -> Structured Export -> Loop Continue
Navigate contains the MercadoLibre product URLs. The consent check looks for common accept buttons and only clicks when one exists. The JavaScript step then parses the MercadoLibre item ID from the URL, requests product data from public item endpoints when possible, loops through review offsets, renders one normalized .uscraper-review-row per review, and hands those rows to Structured Export.
The template is not a listing discovery crawler. For broader discovery, browse the template library first, then use this review workflow for deeper comment analysis on selected product URLs.
mercadoLibre-review-scraper.csvColumn
page_url
Original MercadoLibre product URL processed by the workflow.
Column
product_name
Product title returned from product data or fallback sample row.
Column
product_rating
Average product rating when available.
Column
product_rating_count
Visible or returned count behind the average rating.
Column
price
Current product price captured with the review context.
Column
review_count
Total review count or count discovered during the run.
Column
ai_summary
Summary text when MercadoLibre exposes it.
Column
review_content
Individual review text.
Column
review_date
Review date or displayed date text.
Column
like_count
Helpful-like count when available.
Column
rating
Per-review star rating.
API context
Mercado Libre reviews API vs scraper workflow
People search for mercado libre reviews api, mercadolibre scraper vs api, and mercadolibre reviews scraper alternative because there are several ways to reach similar review data. The right path depends on whether you need an approved integration, a spreadsheet, cloud infrastructure, or code ownership.
| Option | Best fit | Trade-off |
|---|---|---|
| Official MercadoLibre product reviews docs | Approved developer integrations and seller-side workflows | Requires API review, endpoint eligibility, implementation, quotas, and policy work. |
| UScraper review template | No-code users who need a local CSV from reviewed product URLs | Best for supervised batches, not unattended high-volume crawling. |
| Hosted actors or scraper APIs | Teams that want vendor-managed infrastructure and API output | Product URLs and outputs pass through a third party, usually with usage billing. |
| Python or Playwright scraper | Engineering teams that need full control over code and deployment | You own selector updates, retries, blocking, storage, and compliance checks. |
Runbook
How to scrape MercadoLibre reviews to CSV
Import the workflow
Open the related template page, download the hosted JSON, and import it into UScraper.
Replace the sample URL
In Navigate, paste the MercadoLibre product URLs you want to process. Use direct item URLs that include an item ID such as MLA681768775.
Run one visible test
Watch the browser for consent prompts, account verification, blocked responses, or product pages with no reviews. Fix access issues before adding more URLs.
Confirm the export path
In Structured Export, check mercadoLibre-review-scraper.csv, headers, append mode, and the save folder. Use a clean file for the first QA run.
Validate, then scale
Compare several exported rows against the product page, then let Loop Continue move through the rest of your URL list.
Append mode is useful for one combined review file, but test reruns can create duplicates. Before reruns, clear the CSV or deduplicate by page_url, review_content, review_date, and rating.
Quality checks
Validate review rows before scaling
Open the CSV before a larger batch. Check the first, middle, and last rows from the test product and confirm review-level fields are not shifted into the wrong columns.
| Check | What to look for |
|---|---|
| Item match | page_url and product_name describe the product you intended to scrape. |
| Rating sanity | product_rating, product_rating_count, review_count, and row count are plausible together. |
| Text quality | review_content contains real comments, not verification text, page chrome, or blank fallback rows. |
| Dates and likes | review_date and like_count use consistent formats across the run. |
| Duplicates | Repeated rows are expected after reruns unless you clean the append file first. |
The item may have no accessible reviews, the URL may not expose an item ID, MercadoLibre may have served verification, or the endpoint response may have changed. Run the same URL visibly and confirm a .uscraper-review-row appears before export.
FAQ
FAQ
Is it legal to scrape MercadoLibre reviews?
MercadoLibre reviews may be publicly visible, but automated collection can still be limited by MercadoLibre terms, API rules, robots controls, copyright, privacy law, and local marketplace rules. Use modest volume, do not bypass verification or access controls, and get legal review before using exported reviews commercially.
Do I need a MercadoLibre account or API key?
No account login or private API key is built into this UScraper workflow. It opens public product URLs, handles common cookie prompts, parses the item ID, and attempts public product and review endpoints. MercadoLibre can still redirect some sessions to account verification or block endpoint access.
What fields does the MercadoLibre review scraper export?
The CSV includes page_url, product_name, product_rating, product_rating_count, price, review_count, ai_summary, review_content, review_date, like_count, and rating.
Why did my MercadoLibre review export return zero rows?
Zero rows usually mean the item ID was not found, MercadoLibre served account verification, a review endpoint was blocked, the product has no available reviews, the consent step changed, or the response shape changed. Run one URL visibly, resolve prompts, and validate access before scaling.
How many MercadoLibre reviews can I export?
The stock JavaScript loop requests review batches with a limit of 50 and offsets up to 1000 for each input item when the endpoints respond. Real row counts depend on review availability, marketplace behavior, rate limiting, and verification screens.
Can I use the MercadoLibre reviews API instead?
Use official MercadoLibre API documentation when you need an approved integration, seller workflow, or governed developer access. Use the UScraper template when you need a supervised local CSV export from reviewed public product URLs and you want to avoid maintaining scraper code.
For the next step, import MercadoLibre Review Scraper, run one product URL, and compare the CSV against the source page before adding a larger list. For related tutorials, browse the UScraper blog or pair this workflow with other marketplace templates from UScraper templates.