Documentação Técnica

Veículos

Descrição

O dataset de Veículos retorna informações sobre veículos (carros, motos, caminhões, e outros tipos) relacionados com o indivíduo consultado. Os relacionamentos entre indivíduos e veículos são, em sua maioria, construídos a partir de anuncios postados em portais de compra e venda de veículos na internet, e, portanto, não implicam na posse do veículo pela pessoa. Em muitos casos, são veículos que a pessoa já teve e vendeu, ou mesmo que está vendendo em nome de algum terceiro.

Origem da Informação

Todas as informações de veículos tem como origem anúcios de venda de carros, usados ou novos, postados nos principais portais e sites de compra e venda da internet. Estão incluídos desde sites especializados na compra e venda de automóveis (Webmotors, iCarros, Autoline e outros) até sites mais genéricos que incluem carros (OLX, Mercado Livre).

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
docDocumento de identificaçãoCPF🛑 Obrigatório

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": "vehicles",
    "q": "doc{CPF}"  
}  

Filtros

CampoDescrição do filtroTipo do filtroValores Possíveis do Filtro
ModelModelo do veículoContémQualquer palavra-chave de modelo de veículo
CategoryCategoria do veículoIgualA categoria do veículo, conforme tabela acima
FuelTypeTipo de combustívelIgualGASOLINA, ALCOOL, DIESEL, FLEX, etc.
BrandMarca do veículoContémQualquer palavra-chave de marca de veículos
FipeCodeCódigo do veículo na tabela FIPEIgualQualquer código de veículo na tabela FIPE
ModelYearAno do modelo do veículoIgual2006, 2019, 1997, etc.

Abaixo está um exemplo de como utilizar o parâmetro .filter(nome_do_campo=XXXX)

{  
    "Datasets": "vehicles.filter(Model=Qualquer palavra-chave de modelo de veículo)",
    "q": "doc{CPF}"  
}  

Limite

Para utilizar o campo de limite basta utilizar o parâmetro .limit(x)

{  
    "Datasets": "vehicles.limit(10)",
    "q": "doc{CPF}"  
}  

O campo de "categoria" do veículo possuí valores pré-definidos conforme a tabela abaixo

CampoRetorno
CategoryCARROS, CAMINHOES, MOTOS
Language
Authorization
Click Try It! to start a request and see the response here!