Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 13/02/2023

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:






Example:

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

Response:

{
   "paging": {
       "total": 3,
       "limit": 5,
       "offset": 0
   },
   "reviews": [
       {
           "id": 60934080,
           "reviewable_object": {
               "id": "MLM769281453",
               "type": "product"
           },
           "date_created": "2020-05-02T13:18:21Z",
           "status": "published",
           "title": "Es un excelente teléfono muy recomendable...!!!",
           "content": "Buen producto excelente calidad. Trabaja correctamente y sus actualizaciones bien.",
           "rate": 5,
           "valorization": 0,
           "likes": 0,
           "dislikes": 0,
           "reviewer_id": 0,
           "buying_date": "2020-04-16T04:00:00Z",
           "relevance": 10,
           "forbidden_words": 0
       },
       {
           "id": 61913880,
           "reviewable_object": {
               "id": "MLM771812030",
               "type": "product"
           },
           "date_created": "2020-05-13T11:08:42Z",
           "status": "published",
           "title": "Excelente",
           "content": "Excelente compra! todo nuevo  como lo comenta la publicación.",
           "rate": 5,
           "valorization": 0,
           "likes": 0,
           "dislikes": 0,
           "reviewer_id": 0,
           "buying_date": "2020-04-27T04:00:00Z",
           "relevance": 9,
           "forbidden_words": 20
       },
       {
           "id": 60318050,
           "reviewable_object": {
               "id": "MLM769281453",
               "type": "product"
           },
           "date_created": "2020-04-24T21:31:55Z",
           "status": "published",
           "title": "perfecto",
           "content": "Muy bien ekipo sellado nuevo conforme.",
           "rate": 5,
           "valorization": 0,
           "likes": 0,
           "dislikes": 0,
           "reviewer_id": 0,
           "buying_date": "2020-04-20T04:00:00Z",
           "relevance": 6,
           "forbidden_words": 0
       }
   ],
   "rating_average": 5,
   "rating_levels": {
       "one_star": 0,
       "two_star": 0,
       "three_star": 0,
       "four_star": 0,
       "five_star": 3
   },
   "helpful_reviews": {
       "best_max_stars": null,
       "best_min_stars": null
   },
   "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


Nota:
The information in the reviewer_id parameter is obfuscated and it returns the value (0) in all cases.

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/MLB1632704547?catalog_product_id=MLB14186226

Response:

{
  "paging": {},
  "reviews": [
    {},
    {},
    {
      "id": 90579197,
      "reviewable_object": {},
      "date_created": "2020-12-29T12:06:45Z",
      "status": "published",
      "title": "Excelente custo beneficio",
      "content": "Excelente custo beneficio com recursos de celulares top (carregamento sem fio, carrega outros devices como proprio fone, boa capacidade de memoria, rapido, acabamento bonito, tela plana). Como pequena desvantagem: o tamanho da tela poderia ser um pouquiho maior, o que para alguns pode ser uma vantagem.",
      "rate": 5,
      "valorization": 1,
      "likes": 1,
      "dislikes": 0,
      "reviewer_id": 0,
      "buying_date": "2020-11-24T04:00:00Z",
      "relevance": 46,
      "forbidden_words": 50
    },
    {},
    {}
  ],
  "rating_average": 4.6,
  "rating_levels": {
    "one_star": 3,
    "two_star": 0,
    "three_star": 3,
    "four_star": 5,
    "five_star": 44
  },
  "helpful_reviews": [
  ],
  "attributes": [
  ]
}