🚗 FIPE API BRASIL Docs v2.0 • Edge

Documentação Oficial FIPE API BRASIL

A API FIPE mais rápida do Brasil (fipeapibrasil.com.br). Executada diretamente na Edge da Cloudflare com mais de 1 milhão de registros indexados em D1 e latência média inferior a 25ms.

⚡ Degustação Sem Login & Rate Limiting

Você pode testar a API imediatamente sem precisar se cadastrar ou informar cartão. Todas as consultas públicas sem chave de API utilizam a cota gratuita do seu endereço IP.

Plano / Tipo Cota de Consultas Autenticação Ideal para
Público / Visitante 20 req / dia Sem chave (por IP) Testes rápidos e validação no playground
Free (Cadastro) 300 req / mês Chave fipe_live_... Desenvolvimento, estudantes e protótipos
Básico (R$ 9,99) 1.000 req / mês Chave fipe_live_... Para desenvolvedores, projetos e pequenas automações
Starter (R$ 24,00) 10.000 req / mês Chave fipe_live_... Para pequenas lojas, revendas e sites
Pro (R$ 59,00) 100.000 req / mês Chave fipe_live_... Para concessionárias, revendas médias e ERPs
Enterprise (R$ 120,00) 1.000.000 req / mês Chave fipe_live_... Para concessionárias, portais automotivos e apps de alto tráfego
Cabeçalhos HTTP retornados: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (reinicia no 1º dia de cada mês às 00:00 UTC para planos cadastrados).

🔑 Como Autenticar

Para obter 300 requisições mensais gratuitas ou assinar um plano maior a partir de R$ 9,99/mês, crie sua conta no Painel de Usuário e envie sua chave em qualquer requisição:

Header: X-API-Key: fipe_live_xxxxxxxxxxxxxxxxxxxx
(Também aceito via Query Param: ?api_key=fipe_live_...)

🧪 Playground Interativo de Testes

Execute consultas ao vivo e veja os cabeçalhos de rate limit e tempo de resposta.

Testes Rápidos de 1 Clique:
GET
PRONTO 0 ms
Rate Limit: -
// Clique em "Executar ⚡" ou escolha um dos testes rápidos acima para ver a resposta em tempo real!
GET /referencias
Retorna todos os meses e anos de referência disponíveis na base histórica da FIPE.
curl -X GET "https://fipe-api.celhinho16.workers.dev/referencias" \ -H "X-API-Key: SUA_CHAVE_AQUI"
GET /tabela/:tipo_veiculo
Lista todas as marcas registradas para a categoria informada.
Parâmetro :tipo_veiculo: carros (1), motos (2) ou caminhoes (3).
GET /tabela/:tipo/marca/:codigo_marca
Retorna todos os modelos de veículos pertencentes à marca informada.
GET /tabela/:tipo/marca/:marca/modelo/:modelo
Retorna todos os anos/combustíveis disponíveis para o modelo selecionado.
GET /tabela/:tipo/marca/:marca/modelo/:modelo/ano/:ano
Retorna a cotação oficial completa da FIPE com valor atual, mês de referência, combustível e código FIPE.
GET /preco/:codigo_fipe
Consulta rápida e direta pelo código FIPE oficial (ex: 005341-4). Aceita parâmetro opcional ?ano=2020 e ?referencia=337.
GET /historico/:codigo_fipe/:ano
Retorna a evolução histórica mês a mês dos preços daquele veículo, ideal para construção de gráficos e análises de depreciação.
GET /buscar?q=:termo
Busca inteligente textual por marca, nome de modelo ou código FIPE. Aceita parâmetro &limit=20.
GET /filtrar?tipo_veiculo=1&valor_min=...&valor_max=...
Filtra veículos por faixa de preço e opcionalmente por marcas específicas (ex: &marcas=fiat,ford,chevrolet).