Documentação Técnica

Dados de Produtos Relacionados

Descrição

O dataset de Dados de Produtos Relacionados contém informações sobre produtos com algum grau de relação ao produto consultado, capturados nas diferentes fontes. O objeto de retorno têm 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 os dados, consolidados para cada fonte, com informações do total de produtos relacionados e da quantidade de produtos relacionados na mesma categoria. No último nível, trazemos informações como a URL do produto relacionado e o tipo de relação (recomendado, também visto, também comprado, etc...), para cada uma das fontes específicas.

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": "related_product_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": "related_product_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!