Developers

Última atualização em 14/03/2023

Opiniões de produtos

Uma vez o produto seja entregue ao comprador, ele poderá opinar de acordo com a sua experiência. Indicando quantas estrelas daria ao produto, fazendo um comentário e, no caso de um produto de Moda, indicando se o tamanho foi o esperado ou não. Dessa forma, o vendedor poderá ver a média de estrelas de seus produtos para conhecer a satisfação de seus compradores. No Mercado Livre, você verá as estrelas e a quantidade de opiniões sob o título da publicação da seguinte forma:

Com o seguinte recurso, você poderá consultar as estrelas (campo rating_average) que um produto possui de acordo com suas opiniões.
Chamada:

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

Exemplo:

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

Resposta:

{
  "paging": {},
  "reviews": [
    {
      "id": 99576844,
      "reviewable_object": {},
      "date_created": "2021-03-18T14:45:46Z",
      "status": "published",
      "title": "Melhor aquisição do ano!",
      "content": "Adorei a minha air frier!!! espaçosa, prática. Usei apenas uma vez para fazer linguiça frita, e realmente atende aí que promete. Ainda não tive a oportunidade de utilizar mais, mas já amei!.",
      "rate": 4,
      "valorization": 0,
      "likes": 0,
      "dislikes": 0,
      "reviewer_id": 0,
      "buying_date": "2021-03-12T04:00:00Z",
      "relevance": 32,
      "forbidden_words": 0
    },
    {},
    {},
    {},
    {}
  ],
  "rating_average": 4.9,
  "rating_levels": {
    "one_star": 0,
    "two_star": 0,
    "three_star": 0,
    "four_star": 1,
    "five_star": 12
  },
  "helpful_reviews": {},
  "attributes": [
  ]
}

Nota:

A informação do parâmetro reviewer_id está ofuscada e o mesmo devolver o valor (0) em todos os casos.

Campos da resposta

reviews: opiniões sobre produtos.

id: id da opinião.
date_created: data de criação da opinião.
status: estado da opinião (por exemplo, publicada).
tittle: título da opinião.
content: opinião do comprador.
rate: classificação por estrelas (de 1 a 5).
buying_date: data de compra do produto.

rating_average: média do total de opiniões
rating_levels: classificação por estrelas recebidas

Opiniões de itens de catálogo

Usando o catalog_product_id correspondente ao item com optin para catalogo, você pode verificar suas opiniões. Conheça mais sobre publicações de catálogo.

Exemplo:

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

Resposta:

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

Conheça mais sobre Opiniões de produtos.