Mercado Libre

API de opiniones de Mercado Libre

Una página de hasta 15 opiniones de un producto de Mercado Libre, con filtro opcional por estrellas: calificación, texto, el texto original cuando Mercado Libre lo tradujo, fecha exacta, likes, el país donde se escribió la opinión y fotos. Pide páginas hasta que una llegue vacía. Cuesta 1 crédito por solicitud.

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 de producto de catálogo, tal como lo devuelve Búsqueda en product_id (o como aparece en una URL /p/). Su prefijo define el país: MLM México, MLB Brasil, MLA Argentina, MCO Colombia. Pasa exactamente uno de product_id, item_id o url.

Example: MLM1027172667

item_idstring

Id del artículo (publicación), tal como lo devuelve Búsqueda en item_id. También se acepta MLM-3571336480.

Example: MLM3571336480

urlstring

Una URL de producto (/p/), de producto de usuario (/up/) o de página de publicación de Mercado Libre o Mercado Livre de un país soportado.

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

ratinginteger

Solo opiniones con esta calificación en estrellas, de 1 a 5.

Example: 1

pageintegerdefault:1

Página de opiniones, empezando en 1, hasta 15 opiniones por página. Una página posterior a la última llega vacía.

Example: 2

Notes

Pide páginas hasta que una llegue vacía. Cada página trae hasta 15 opiniones, y una página puede traer menos aunque haya más después, así que no hay un indicador confiable de "hay más": pide la página siguiente hasta que count sea 0. Los totales de opiniones y la distribución de estrellas vienen de Producto (rating.count, rating.distribution).

Opiniones traducidas y de varios países. Un producto de catálogo junta opiniones de varios países de Mercado Libre y las muestra en el idioma del sitio. Cuando una opinión se tradujo, translated es true y original_text conserva el original (la primera opinión capturada se escribió en portugués en Mercado Livre Brasil). site_id, country y reviewer_country indican de dónde viene cada opinión; country es null para un sitio que la API no cubre, como Chile (MLC).

Opiniones cuesta 1 crédito por página, la mitad que los demás endpoints de Mercado Libre.
text puede venir vacío en opiniones que solo tienen fotos; media lista las fotos.
Un id desconocido devuelve 404 y se cobra. Con un filtro rating, un nivel de estrellas sin opiniones devuelve una página vacía. Las fallas temporales (502/503) nunca se cobran.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Todas las opiniones de 1 estrella, 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 las opiniones de 1 estrella, 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