Opiniones de productos

Una vez entregado el producto al comprador, este podrá opinar de acuerdo a su experiencia indicando cuántas estrellas le daría al producto, realizar un comentario y, en caso de ser un producto de Moda, indicar si le quedó como esperaba o no. De esta manera, el vendedor podrá saber el promedio de estrellas sobre sus productos. En Mercado Libre, verán las estrellas y cantidad de opiniones debajo del título de la publicación de la siguiente manera:

Consultar opinión media de un producto

Con la siguiente llamada, puedes averiguar las estrellas (campo rating_average) que tiene un producto según sus opiniones. Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reviews/item/$ITEM_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reviews/item/MLA9100270

Respuesta:

{
  "paging": {},
  "reviews": [
    {},
    {},
    {
      "id": 41672915,
      "reviewable_object": {},
      "date_created": "2019-06-08T14:12:29Z",
      "status": "published",
      "title": "Iincreíble, lo amo",
      "content": "Impresionante, muy satisfecha con el samsung s9, tenía un s7 y son todos excelentes! lo único que le encontré es q luego de una actualización de software, que x lo gral lo programo para la noche, el telefono no vuelve a encender solo, y por eso no suena la alarma de la mañana. Todavia no he terminado de descubrir todo, pero la rapidez y reaccion de todo el teléfono es genial.",
      "rate": 5,
      "valorization": 0,
      "likes": 0,
      "dislikes": 0,
      "reviewer_id": 79635117,
      "buying_date": "2019-04-12T04:00:00Z",
      "relevance": 71,
      "forbidden_words": 0
    },
    {},
    {}
  ],
  "rating_average": 4.8,
  "rating_levels": {
    "one_star": 2,
    "two_star": 1,
    "three_star": 0,
    "four_star": 9,
    "five_star": 80
  },
  "helpful_reviews": {},
  "attributes": [
  ]
}

Campos de la respuesta

reviews: opiniones de producto

id: id de la opinión
date_created: fecha de la creación de la opinión
status: estado de la opinión (por ejemplo, publicada)
tittle: título de la opinión
content: contenido de la opinión
rate: valoración en estrellas (de 1 a 5)
buying_date: fecha de la compra del producto

rating_average: promedio de las valoraciones totales
rating_levels: clasificación por estrellas recibidas

Detalles de productos de Moda

Con este recurso obtienes información de cada opinión de los vendedores de la vertical Moda. Además, observas el porcentaje de tamaño sobre cómo le quedó el producto al comprador. Conoce más cómo trabajar con Guía de talles.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reviews/object/$ITEM_ID/attributes

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reviews/object/MLA813473400/attributes

Respuesta:

[
  {
    "attribute_id": 1,
    "catalog_attribute_name": "Talle",
    "values_responses": [
      {
        "id": 4,
        "name": "Chico",
        "total": 0
      },
      {
        "id": 3,
        "name": "Algo chico",
        "total": 0
      },
      {
        "id": 2,
        "name": "Como esperaba",
        "total": 48
      },
      {
        "id": 5,
        "name": "Algo grande",
        "total": 2
      },
      {
        "id": 1,
        "name": "Grande",
        "total": 0
      }
    ],
    "total_responses": 50,
    "vip_summary": {
      "text": "Al %1$s le quedó como esperaba",
      "value": "96%",
      "selected_values": [
        2
      ]
    }
  }
]

Campos de respuesta

vip_summary: array resumen visible en el front de Mercado Libre. text: descripción de las opiniones recibidas de acuerdo al Talle. value: porcentaje descrito en el campo text

Consultar opiniones de ítem de catálogo

Utilizando el catalog_product_id correspondiente al ítem con optin a catálogo, puedes consultar sus opiniones. Conoce más cómo publicaciones de Catálogo.

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reviews/item/MLA723647586?catalog_product_id=MLA9100270

Respuesta:

{
  "paging": {},
  "reviews": [
    {},
    {},
    {},
    {
      "id": 43083524,
      "reviewable_object": {},
      "date_created": "2019-07-17T23:11:29Z",
      "status": "published",
      "title": "Perfecto¡¡¡",
      "content": "Excelente producto, recomendable 100%.",
      "rate": 5,
      "valorization": 2,
      "likes": 2,
      "dislikes": 0,
      "reviewer_id": 85391865,
      "buying_date": "2019-06-22T04:00:00Z",
      "relevance": 4,
      "forbidden_words": 0,
      "attributes": []
    },
    {}
  ],
  "rating_average": 4.8,
  "rating_levels": {},
  "helpful_reviews": [
  ],
  "attributes": [
  ]
}

Conoce más sobre Métricas de venta.