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_...)
(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:
// 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
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).