Documentação

Guia completo para integrar a API Fipe no seu projeto.

Sobre

A API Fipe expressa preços médios de veículos anunciados pelos vendedores no mercado nacional, servindo como um parâmetro para negociações ou avaliações.

Token

O Token para uso da API é fornecido após a confirmação de pagamento do seu Plano.

💡 Você pode obter um token de demonstração gratuito, basta criar sua conta e acessar o Dashboard para visualizar o token.

Informações

A API fornece os dados através de uma URL utilizando o método GET.

URL base:

https://apifipe.com.br/api/tipo/token

O parâmetro tipo define o tipo de veículo: carros, motos, caminhoes ou fipe.

O tipo fipe consulta todos os veículos com aquele código FIPE.

⚠️ Veículo com o ano 32000 é referente a um veículo 0 Km.

O parâmetro codAno é composto pela junção do ano de fabricação (-) código do combustível: 1(Gasolina), 2(Álcool), 3(Diesel), 4(Elétrico), 5(Flex), 6(Híbrido). Ex: 2012-1

Marcas

Liste as marcas de um tipo de veículo. Exemplo para carros:

GET https://apifipe.com.br/api/carros/token

json

[
  {
    "codMarca": 1,
    "refFipe": 286,
    "nomeMarca": "Acura",
    "tipoVeiculo": 1
  },
  {
    "codMarca": 2,
    "refFipe": 286,
    "nomeMarca": "Agrale",
    "tipoVeiculo": 1
  }
]

Modelos

Liste os veículos de uma marca, informando o codMarca. Ex: BMW = 7

GET https://apifipe.com.br/api/carros/7/token

json

[
  {
    "codModelo": "6146",
    "codMarca": 7,
    "nomeModelo": "116iA 1.6 TB 16V 136cv 5p",
    "refFipe": 286,
    "tipoVeiculo": 1
  },
  {
    "codModelo": "8946",
    "codMarca": 7,
    "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
    "refFipe": 286,
    "tipoVeiculo": 1
  }
]

Anos

Informe codMarca e codModelo para listar os anos disponíveis.

GET https://apifipe.com.br/api/carros/7/8946/token

json

[
  {
    "codModelo": 8946,
    "codMarca": 7,
    "tipoVeiculo": 1,
    "refFipe": "286",
    "nomeAno": "32000 Gasolina",
    "codAno": "32000-1"
  },
  {
    "codModelo": 8946,
    "codMarca": 7,
    "tipoVeiculo": 1,
    "refFipe": "286",
    "nomeAno": "2022 Gasolina",
    "codAno": "2022-1"
  }
]

Valor

Adicione o codAno para obter o preço FIPE do veículo.

GET https://apifipe.com.br/api/carros/7/8946/2021-1/token

json

{
  "codModelo": "8946",
  "codMarca": 7,
  "tipoCombustivel": "Gasolina",
  "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
  "siglaCombustivel": "G",
  "codFipe": "009258-4",
  "refFipe": 286,
  "nomeMarca": "BMW",
  "refMes": "junho de 2022",
  "valorVeiculo": "R$ 228.091,00",
  "anoModelo": "2021",
  "tipoVeiculo": 1
}

Código Fipe

Consulte veículos a partir do código FIPE.

GET https://apifipe.com.br/api/fipe/009258-4/token

json

[
  {
    "codModelo": "8946",
    "codMarca": 7,
    "tipoCombustivel": "Gasolina",
    "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
    "siglaCombustivel": "G",
    "codFipe": "009258-4",
    "refFipe": 286,
    "nomeMarca": "BMW",
    "refMes": "junho de 2022",
    "valorVeiculo": "R$ 289.928,00",
    "anoModelo": "32000",
    "tipoVeiculo": 1
  }
]

Código Fipe + Ano

Consulte o preço a partir do código FIPE e ano específico.

GET https://apifipe.com.br/api/fipe/009258-4/2021-1/token

json

{
  "codModelo": "8946",
  "codMarca": 7,
  "tipoCombustivel": "Gasolina",
  "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
  "siglaCombustivel": "G",
  "codFipe": "009258-4",
  "refFipe": 286,
  "nomeMarca": "BMW",
  "refMes": "junho de 2022",
  "valorVeiculo": "R$ 228.091,00",
  "anoModelo": "2021",
  "tipoVeiculo": 1
}

ℹ️ Usa-se o parâmetro codAno por existirem casos de veículos com mais de um tipo de combustível no mesmo ano.

Exemplos de uso

Veja como consumir a API em diferentes linguagens. Substitua SEU_TOKEN pelo seu token real.

Usando fetch (Node.js / Browser):

javascript

const TOKEN = "SEU_TOKEN";
const BASE = "https://apifipe.com.br/api";

// Listar marcas de carros
const res = await fetch(`${BASE}/carros/${TOKEN}`);
const marcas = await res.json();
console.log(marcas);

// Buscar valor de um veículo
const valor = await fetch(`${BASE}/carros/7/8946/2021-1/${TOKEN}`);
const dados = await valor.json();
console.log(dados.valorVeiculo); // "R$ 228.091,00"

Códigos de retorno

Código	Descrição
200	Retorno com sucesso.
400	URL incorreta!
401	Token inválido!
402	Limite de consultas atingido!
406	Sem resultados!
500	Erro no servidor!

Todos os códigos de erro retornam com uma mensagem detalhando o erro:

json

{
  "mensagem": "Formado do token inválido! Cod.(7006)"
}