Documentação Técnica

Dados de Disponibilidade

Descrição

O dataset de Dados de Disponibilidade contém informações relacionadas com a disponibilidade do produto consultado, capturado em diferentes fontes. O objeto de retorno têm uma estrutura hierárquica que segue a estrutura Dados Gerais -> Dados Detalhados por Fonte. 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 detalhadas por fonte, que vão desde dados do histórico de esgotamento do produto até o histórico de quantidade em estoque, quando existente.

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