Documentação Técnica

Dados de Avaliações

Descrição

O dataset de Dados de Avaliações contém informações relacionadas às avaliações associadas ao produto consultado, capturadas em diferentes fontes. O objeto de retorno tem uma estrutura hierárquica que segue a estrutura Dados Gerais -> Dados Consolidados de Fontes -> Dados Detalhados da Captura. No primeiro nível, apresentamos informações gerais sobre o produto como o seu identificador principal e identificadores alternativos, quando houver. No segundo nível, apresentamos informações gerais sobre a quantidade de avaliações, melhores e piores notas, sua variação em diferentes intervalos de tempo, o conteúdo da melhor avaliação e diversos indicadores, agregando os dados de todas as fontes disponíveis. No último nível, são apresentadas as informações e indicadores agregados para cada fonte. Além disso, para cada fonte, retornamos todas as informações capturadas das avaliações, como conteúdo, nota, autor, etc.

Origem da Informação

Assim como os outros datasets de produtos, os dados retornados aqui são capturados diretamente de dezenas de lojas online e marketplaces como Saraiva, Pontofrio, Casas Bahia, Extra, Submarino, Shoptime, Americanas, Walmart e Magazine Luiza.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,050
10001 - 50000R$ 0,048
50001 - 100000R$ 0,046
100001 - 500000R$ 0,044
500001 - 1000000R$ 0,042
1000001 - 5000000R$ 34.000,00 (preço fixo)
5000001 e acimaEntre em contato

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
eanNúmero do código de barrasxxxxxxxxxxxxxx🛑 Obrigatório
isbnInternational Standard Book Numberxxx-x-xx-xxxxxx-x🔑 Chave Alternativa
brandMarca dos produtosxxxxxxxxx🔑 Chave Alternativa
categoryCategoria de produtosxxxxxxxxxxxxxx🔑 Chave Alternativa
searchtermsPesquisa de palavras-chavesTexto🔑 Chave Alternativa

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "review_data",
    "q": "ean{NUMBER}"  
}  

Paginação

A paginação do dataset pode ser feita através do parâmetro .next(x), utilizando o ID retornado pela requisição anterior e um parâmetro de consulta q com o mesmo parâmetro inserido na consulta original, conforme o exemplo abaixo:

{  
    "Datasets": "review_data.next(Id da próxima página)",
    "q": "ean{NUMBER}"  
}  
Language
Authorization
Click Try It! to start a request and see the response here!