Mercado Livre Product Reviews API
Scrape Mercado Livre product reviews instantly with a simple API call
A GET request to the /api/getter/?platform="mercado_reviews" endpoint allows you to scrape customer reviews for any product listing URL on Mercado Livre in real-time.
Example
Here's how you can scrape reviews for this product with our API:
1 | |
1 2 3 4 5 | |
1 2 3 | |
1 2 3 4 5 6 | |
1 2 3 4 5 6 | |
Query Parameters
Our endpoint accepts the following query parameters:
Product URL
url
Required
Product listing's URL on Mercado Livre. Please remove unnecessary query parameters and encode the URL.
Page Number
page
Optional
The page number for which you want the results. Default value is 1.
Other Required Parameters
platform
Required
Specifies the scraping engine you wish to invoke. In this case, the value should be mercado_reviews.
api_key
Required
Your account's token—which can be obtained by signing up here.
URL encoding
The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.
Total results and no. of pages not known
Unlike other reviews APIs, the total number of results and pages are not available in the API response for the Mercado Livre Product Reviews API. To scrape all reviews, iterate through page numbers starting from 1, incrementing by 1 for each subsequent request. Stop iterating when a request returns 0 reviews, or fewer than 10 reviews (which indicates that it's the last page).
Results
The response will include the following attributes for each review:
| Attributes Returned | Data Type | Information Represented |
|---|---|---|
| review_id | string/int | Retailer ID of the review |
| date | string | Date when review was published |
| rating | int | Rating provided by the reviewer |
| review_title | string | Title of the review (if any) |
| review_text | string | Text content of the review |
| review_imgs | list | Links to reviewer's images, if any |
| review_videos | list | Links to reviewer's videos, if any |
| meta_data | dict | Dictionary containing meta data, such as helpful vote count |
| meta_data.helpful_vote_count | int | Number of helpful votes the review has received |
Response Example
Each request returns up to 10 results. Here's the response you can expect for the request showcased above:
{
"success": true,
"product_id": "MLB24005656",
"page": 1,
"result_count": 10,
"reviews": [
{
"review_id": 1822013748,
"date": "2025-01-30",
"rating": 5,
"review_title": "excelente",
"review_text": "Maravilhosa atendeu minhas espectativas.",
"review_imgs": [],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
},
{
"review_id": 1819245832,
"date": "2025-01-29",
"rating": 4,
"review_title": "muito bom",
"review_text": "Muito bonita, mas achei que a luz de temperatura é muito imperceptível, especialmente no claro, deveria ter uma cor, azul por exemplo. Também acho que a forma para gelo deveria ter os compartimentos menores, as pedras são muito grandes.",
"review_imgs": [],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
},
{
"review_id": 1805915249,
"date": "2025-01-25",
"rating": 5,
"review_title": "excelente",
"review_text": "Tem sido uma ótima escolha. Bem silenciosa mesmoo e gela muito bem, nunca precisei aumentar a potência do freezer pra mais de 1.",
"review_imgs": [],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
},
{
"review_id": 1785936891,
"date": "2025-01-16",
"rating": 5,
"review_title": "excelente",
"review_text": "Exelente!.",
"review_imgs": [],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
},
{
"review_id": 1783975000,
"date": "2025-01-14",
"rating": 5,
"review_title": "excelente",
"review_text": "Ótimo.",
"review_imgs": [],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
},
{
"review_id": 1782251204,
"date": "2025-01-13",
"rating": 5,
"review_title": "excelente",
"review_text": "Ótima geladeira.",
"review_imgs": [],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
},
{
"review_id": 1777325184,
"date": "2025-01-11",
"rating": 5,
"review_title": "excelente",
"review_text": "",
"review_imgs": [
"https://http2.mlstatic.com/D_NQ_NP_754632-MLA81897106999_012025-F.jpg",
"https://http2.mlstatic.com/D_NQ_NP_854822-MLA81896902089_012025-F.jpg"
],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
},
{
"review_id": 1762211328,
"date": "2025-01-05",
"rating": 5,
"review_title": "excelente",
"review_text": "Super recomendo, geladeira super silencioso e muito espaçosa.",
"review_imgs": [],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
},
{
"review_id": 1742577013,
"date": "2024-12-30",
"rating": 5,
"review_title": "excelente",
"review_text": "2 meses com a geladeira e não tenho nada a reclamar. Também é muito bonita e a refrigeração é ótima. Estou amando.",
"review_imgs": [],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
},
{
"review_id": 1738650446,
"date": "2024-12-27",
"rating": 5,
"review_title": "excelente",
"review_text": "Muito bom porém, a borracha da porta não tem boa vedação.",
"review_imgs": [],
"review_videos": [],
"meta_data": {
"helpful_vote_count": 0
}
}
],
"meta_data": {},
"remaining_credits": 1939951.0
}
Request Cost
10 credits are deducted for each successful request
Support
If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com