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:




Conteúdos

→Consultar a opinião de um produto →Detalhes de produtos Moda →Consultar opiniões de itens de Catálogo

Consultar a opinião de um produto

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

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


Detalhes de produtos Moda

Com esse recurso, você obtém informação de cada opinião de seus vendedores, e nos produtos da vertical Moda, você observa a valorização de tamanhos segundo os compradores. Conheça mais sobre como trabalhar com Tabelas de medidas.




Chamada:

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

Exemplo:

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

Resposta:

[
  {
    "attribute_id": 2,
    "catalog_attribute_name": "Tamanho",
    "values_responses": [
      {
        "id": 7,
        "name": "Pequeno",
        "total": 2
      },
      {
        "id": 8,
        "name": "Um pouco pequeno",
        "total": 10
      },
      {
        "id": 10,
        "name": "Perfeito",
        "total": 172
      },
      {
        "id": 9,
        "name": "Um pouco grande",
        "total": 44
      },
      {
        "id": 6,
        "name": "Grande",
        "total": 10
      }
    ],
    "total_responses": 238,
    "vip_summary": {
      "text": "Perfeito para %1$s",
      "value": "72%",
      "selected_values": [
        10
      ]
    }
  }
]

Campos da resposta

vip_summary: array resumo visível text: descrição das opiniões recebidas de acordo com o tamanho. value: porcentagem descrita no campo text

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": 32319400,
      "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": [
  ]
}
ou registre-se para receber as últimas notícias sobre nossa API