Products reviews

Once the product has been delivered to the buyer, he or she will be able to give an opinion according to their experience indicating how many stars they would give the product, make a comment and, in the case of a Fashion product, indicate if it was as expected or not. In this way, the seller will be able to know the average of stars on his products. In Mercado Libre, you will see the stars and number of opinions under the title of the publication as follows:




Contents

→Check a product's opinion →Product details Moda →Check catalog item opinions

Check a product's opinion

With this request, you can find out the stars (rating_average field) that a product has according to their opinions. Request:

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

Example:

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

Response:

{
  "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": [
  ]
}

Response fields

reviews: product reviews

  • id: opinion id
  • date_created: opinion creation date
  • status: review status (for example, published)
  • tittle: opinion title
  • content: opinion content
  • rate: star rating (from 1 to 5)
  • buying_date: product purchase date

rating_average: average of total reviews
rating_levels: star rating received


Product details Moda

With this resource you obtain the attributes of each opinion, and especially in products of the Moda vertical, you observe the percentage of valuation on how the product was left to the buyer, for example:




Request:

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

Example:

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

Response:

[
  {
    "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
      ]
    }
  }
]

Response fields

vip_summary: summary array on the Mercado Libre front. text: description of the opinions received according to the Size. value: percentage described in the text field

Check catalog item opinions

Using the catalog_product_id corresponding to the item with optin to catalog, you can check their opinions.

Example:

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

Response:

{
  "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": [
  ]
}
or register to recieve the latest news about our API