Mercado Livre

API de avaliações do Mercado Livre

Uma página com até 15 avaliações de um produto do Mercado Livre, com filtro opcional por estrelas: nota, texto, o texto original quando o Mercado Livre o traduziu, data exata, curtidas, o país onde a avaliação foi escrita e fotos. Pagine até uma página voltar vazia. Custa 1 crédito por requisição.

POST/api/v1/mercadolibre/reviews

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

product_idstring

Id do produto de catálogo, como a busca o retorna em product_id (ou numa URL /p/). O prefixo define o país: MLM México, MLB Brasil, MLA Argentina, MCO Colômbia. Passe exatamente um entre product_id, item_id ou url.

Example: MLM1027172667

item_idstring

Id do item (anúncio), como a busca o retorna em item_id. MLM-3571336480 também é aceito.

Example: MLM3571336480

urlstring

Uma URL de produto (/p/), de user product (/up/) ou de página de anúncio do Mercado Libre ou do Mercado Livre de um país suportado.

Example: https://www.mercadolibre.com.mx/apple-iphone-15-128-gb-azul-distribuidor-autorizado/p/MLM1027172667

ratinginteger

Só avaliações com esta nota em estrelas, de 1 a 5.

Example: 1

pageintegerdefault:1

Página de avaliações, começando em 1, com até 15 avaliações por página. Uma página além da última volta vazia.

Example: 2

Notes

Pagine até uma página vir vazia. Cada página traz até 15 avaliações, e uma página pode trazer menos mesmo havendo mais em seguida, então não há um indicador confiável de "tem mais": peça a próxima página até count ser 0. Os totais de avaliações e a distribuição de estrelas vêm de Produto (rating.count, rating.distribution).

Avaliações traduzidas e reunidas. Um produto de catálogo junta avaliações de vários países do Mercado Livre e as mostra no idioma do site. Quando uma avaliação foi traduzida, translated é true e original_text mantém o original (a primeira avaliação capturada foi escrita em português no Mercado Livre Brasil). site_id, country e reviewer_country dizem de onde veio cada avaliação; country é null para um site que a API não atende, como o Chile (MLC).

Avaliações custam 1 crédito por página, metade dos outros endpoints do Mercado Livre.
text pode vir vazio em avaliações só com fotos; media lista as fotos.
Um id desconhecido retorna 404 e é cobrado. Com o filtro rating, um nível de estrelas sem avaliações retorna uma página vazia. Falhas temporárias (502/503) nunca são cobradas.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Todas as avaliações de 1 estrela, 15 por página, 1 crédito por página
page = 1
while True:
    res = client.mercadolibre.reviews(product_id="MLM1027172667", rating=1, page=page)
    reviews = res["data"]["reviews"]
    if not reviews:
        break
    for r in reviews:
        print(r["created_at"], r["country"], r["original_text"] or r["text"])
    page += 1

Response

"country": "mx",

"site_id": "MLM",

"product_id": "MLM1027172667",

"item_id": null,

"rating": null,

"page": 1,

"page_size": 15,

"count": 12,

"response_time": 2030

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Todas as avaliações de 1 estrela, 15 por página, 1 crédito por página page = 1 while True: res = client.mercadolibre.reviews(product_id="MLM1027172667", rating=1, page=page) reviews = res["data"]["reviews"] if not reviews: break for r in reviews: print(r["created_at"], r["country"], r["original_text"] or r["text"]) page += 1