API Fipe - Documentação

API Fipe!

API atualizada conforme os dados disponíveis no site da FIPE.

Esta API Fipe fornece os dados de veículos disponíveis na tabela fipe através de consulta direta em web service próprio. Tais como, preço dos veículos, marcas de carros, motos e caminhões e outros dados disponíveis conforme a Fipe.

Funcionamento.

Nossa API consulta em tempo real os dados disponíveis direto em nosso banco de dados. Os veículos e valores disponibilizados pela API são atualizados conforme os dados da FIPE.

Utilização da API Fipe.

Token de utilização liberado mediante cadastro neste link "Cadastrar".

A API fornece os dados através de uma url em Json. Segue abaixo a url de exemplo:

http://api.fipeapi.com.br/v1/[tipo]?{apikey}

O parametro [tipo] serve para listar os tipos de veículos: carros, motos, caminhoes ou fipe.
Também podem ser usados numeros: 0(fipe) 1(Carros), 2(Motos) e 3(Caminhões).
O parametro tipo com valor fipe consulta todos os veículos com aquele codigo fipe.
O parametro [acao] relaciona os dados que você deseja obter.
Primeiramente, liste as marcas de um tipo de veiculo que deseja através da ação "marcas" sem nenhum parâmetro conforme exemplo abaixo:

*Veículo de ano 32000 é referente a veículo 0 Km
*O parâmetro "id_modelo_ano" é composto pela junção do ano de fabricação do veículo "-" código do combustivel. Sendo esses 1(Gasolina), 2(Álcool) e 3(Diesel)

http://api.fipeapi.com.br/v1/carros?{apikey}

Você receberá os dados no formato JSON:

[
  {
    "id": "43",
    "tipo": "1",
    "name": "Nissan"
  },
  {
    "id": "44",
    "tipo": "1",
    "name": "Peugeot"
  }
...
]

Em seguida será possível obter a listagem dos veículos de uma determinada marca, através da ação "veiculos" juntamente com o código (id) da marca em questão. Ex. marca "Ford" tem como seu id "22". Veja abaixo:

http://api.fipeapi.com.br/v1/carros/22?{apikey}

[
	{
	 "tipo": "1",
	 "id_marca": "22",
	 "name": "Corcel II L",
	 "id_modelo": "664"
	},
	{
	 "tipo": "1",
	 "id_marca": "22",
	 "name": "Courier 1.3i/Furgão",
	 "id_modelo": "665"
	},
	{
	 "tipo": "1",
	 "id_marca": "22",
	 "name": "Courier 1.6 L/ 1.6 Flex",
	 "id_modelo": "666"
	}
 ...
]

Ao escolher o veículo, é possível obter os modelos e anos disponíveis para consulta de preços. Através da ação "veiculo" junto com o código da marca e o "id" do veículo. Ex. KA 1.0i 3p:

O resultado será:

http://api.fipeapi.com.br/v1/carros/22/664?{apikey}

[
	{
		"tipo": "1",
		"id_marca": "22",
		"id_modelo": "664",
		"id_modelo_ano": "1986-1",
		"name": "1986 Gasolina",
		"id": "1986-1"
	},
	{
		"tipo": "1",
		"id_marca": "22",
		"id_modelo": "664",
		"id_modelo_ano": "1985-1",
		"name": "1985 Gasolina",
		"id": "1985-1"
	}
]

Para finalizar, adicionando mais um parâmetro a ação "veiculo" será possível visualizar o preço conforme a Tabela FIPE para este [veiculo]/[modelo]/[ano]. Continuando com o exemplo a cima para obter o valor de um veículo do ano 2013 a Gasolina utilizaremos o id 2013-1:

http://api.fipeapi.com.br/v1/carros/22/664/1985-1?{apikey}

Como resposta, temos o objeto JSON relacionado aos dados do veículo em questão veículo:

{
	"id": "5718",
	"tipo": "1",
	"id_modelo_ano": "1985-1",
	"fipe_codigo": "003128-3",
	"id_marca": "22",
	"marca": "Ford",
	"id_modelo": "664",
	"modelo": "Corcel II L",
	"ano": "1985",
	"name": "Corcel II L",
	"combustivel": "Gasolina",
	"preco": "R$ 2.880,00",
	"ano_modelo": "1985"
}

Desta forma recebemos todos os dados do veículo Corcel II L Gasolina, inclusive seu preço atual.



Caso deseje consultar os possíveis veículos a partir do código fipe você pode requisita-los da seguinte forma v1/fipe/[codigo-fipe].

http://api.fipeapi.com.br/v1/fipe/003128-3?{apikey}

De resposta, recebemos o array JSON relacionado aos dados dos veículos que correspondem à código fipe:

[
	{
		"id": "45276",
		"tipo": "1",
		"id_modelo_ano": "1986-1",
		"fipe_codigo": "003128-3",
		"id_marca": "22",
		"marca": "Ford",
		"id_modelo": "664",
		"modelo": "Corcel II L",
		"ano": "1986",
		"name": "Corcel II L",
		"combustivel": "Gasolina",
		"preco": "R$ 3.159,00"
	},
	...
]


Caso deseje consultar o preço a partir do codigo fipe e ano você pode requisita-los da seguinte forma v1/fipe/[codigo-fipe]/[ano].

http://api.fipeapi.com.br/v1/fipe/003128-3/1986-1?{apikey}

Obs. Usa-se o parametro "id_modelo_ano" por existirem casos de veículos com mais de um tipo de combustível no mesmo ano

De resposta, recebemos o objeto JSON relacionado aos dados dos veículos que correspondem à código fipe:

{
	"id": "45276",
	"tipo": "1",
	"id_modelo_ano": "1986-1",
	"fipe_codigo": "003128-3",
	"id_marca": "22",
	"marca": "Ford",
	"id_modelo": "664",
	"modelo": "Corcel II L",
	"ano": "1986",
	"name": "Corcel II L",
	"combustivel": "Gasolina",
	"preco": "R$ 3.159,00"
}