Documentação Oficial FIPE API BRASIL

Consulte preços, referências, histórico e imagens de veículos pelo fipeapibrasil.com.br. API REST de alta performance com banco de dados sólido e atualizado mensalmente.

Aplicativo Android Oficial: Preço Veicular - Tabela Fipe

Alimentado em tempo real por esta mesma infraestrutura de alta velocidade na Edge.

📱 Baixar no Google Play ↗

⚡ 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	5 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 (Free renova no dia 1, UTC; planos pagos têm ciclo de 30 dias a partir da ativação). A cota Free também é compartilhada por IP. Os contadores são aproximados sob concorrência.

🔑 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

          (Prefira o header. Chaves na URL ficam expostas em históricos e logs.)

⏳ Viagem no Tempo (Histórico)

Catálogo, cotações e filtro usam a referência mais recente disponível no banco. Para selecionar outro mês, adicione ?referencia=CODIGO nessas consultas. Histórico, comparação e logotipos não usam esse parâmetro.

          GET /preco/005341-4 (Mês Atual)

          GET /preco/005341-4?referencia=312 (Consulta a referência 312; veja o mês em /referencias)

Use o endpoint /referencias para listar os códigos de todos os meses anteriores. Todos os índices do banco são otimizados para essa viagem no tempo.

Imagens dos veículos e contrato OpenAPI

As cotações em /preco/{codigo_fipe}, /preco, /valor e no caminho completo de /tabela podem incluir foto e midia para planos pagos e RapidAPI. Free e visitantes recebem os dados de preço sem esses campos.

A foto é opcional. Sem associação segura para o ano e a categoria, foto é omitido e midia informa o motivo e uma URL de placeholder neutro. Uma imagem pode representar uma família de veículos: não garante ano, cor ou versão. As URLs das imagens são públicas e não exigem a chave de consulta.

{
  "foto": "https://cdn.exemplo.com/veiculo.webp",
  "midia": {
    "foto_principal": "https://cdn.exemplo.com/veiculo.webp",
    "thumb": "https://cdn.exemplo.com/veiculo-thumb.webp",
    "galeria": ["https://cdn.exemplo.com/veiculo.webp"],
    "fonte": "cdn_proprio",
    "correspondencia": "codigo_fipe",
    "precisao": "ilustrativa",
    "revisao": "pendente",
    "ano_inicio": null,
    "ano_fim": null
  }
}

Exemplo ilustrativo. correspondencia indica codigo_fipe ou modelo. Se não existir thumbnail, usa a principal. Sem galeria, retorna uma lista com a principal. Quando foto estiver ausente, use midia.placeholder_url. Confira midia.precisao e midia.revisao: cadastro antigo não equivale a revisão visual. Imagens revisadas podem informar geração, carroceria, faixa de anos, fonte e licença.

GET /marcas/logos?tipo_veiculo=1 retorna logotipos. O endpoint /fotos/{codigo_fipe} continua em testes internos e responde 404 para clientes. /filtrar não inclui fotos.

Baixar contrato OpenAPI

O contrato reúne as consultas e aliases. Conta, cobrança e administração são operações separadas. No RapidAPI, use os headers do marketplace; a chave do proxy pertence apenas ao servidor.

🧪 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 os meses e anos de referência disponíveis na base oficial da FIPE (referências recentes indexadas).

curl -X GET "https://fipeapibrasil.com.br/referencias" -H "X-API-Key: SUA_CHAVE_AQUI"

const res = await fetch('https://fipeapibrasil.com.br/referencias', { headers: { 'X-API-Key': 'SUA_CHAVE_AQUI' } }); const dados = await res.json();

import requests res = requests.get('https://fipeapibrasil.com.br/referencias', headers={'X-API-Key': 'SUA_CHAVE_AQUI'}) dados = res.json()

GET /referencia_atual

Retorna apenas o código e mês da tabela FIPE ativa no momento (ex: {"codigo":338,"mes":"outubro de 2026"}). O mês corresponde ao dado disponível no banco, não a uma garantia de atualização diária.

GET /tabela/:tipo_veiculo • /marcas/:tipo

Lista todas as marcas registradas para a categoria informada.
Parâmetro :tipo_veiculo: carros (1), motos (2) ou caminhoes (3).
Suporta atalhos: /marcas/carros e query string /marcas?tipo_veiculo=1. Aceita ?referencia=... para dados de meses anteriores.

GET /tabela/:tipo/marca/:marca • /modelos/:tipo/:marca

Retorna todos os modelos de veículos da marca informada.
Suporta tanto o nome quanto IDs legados: ex: Fiat, Toyota, Volkswagen ou ID 59.
Suporta query string: /modelos?tipo_veiculo=1&marca=Fiat e parâmetro de mês ?referencia=...

GET /tabela/:tipo/marca/:marca/modelo/:modelo • /anos/...

Retorna todos os anos e combustíveis disponíveis para o modelo selecionado (aceita nome exato, termo parcial ou ID legado).
Suporta query string: /anos?tipo_veiculo=1&marca=Fiat&modelo=Palio e parâmetro de mês ?referencia=...

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, código FIPE e autenticação FIPE.
Aceita tanto ano puro (ex: 2015) quanto com sufixo (ex: 2016-1, 2016 Flex). Suporta ?referencia=....

GET /preco/:codigo_fipe

Consulta rápida e direta pelo código FIPE oficial (ex: 005341-4). Aceita parâmetros opcionais ?ano=2013 (ou 4 dígitos) e ?referencia=338.
Também acessível via query: /preco?fipe=005341-4 ou /preco?marca=...&modelo=...&ano=....

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.
Aceita ano em formato simples (ex: 2022) ou com sufixo (ex: 2022-1). Também aceita via query: /historico?fipe=...&ano=....

GET /filtrar?tipo_veiculo=...&valor_min=...&valor_max=...

Filtra veículos por faixa de preço e opcionalmente por marcas específicas (ex: &marcas=fiat,ford,chevrolet). Aceita &tipo_veiculo=carros (ou 1, 2, 3), &referencia=... e &limit=20.
⚡ Limite por Chamada: Free/Anônimo: até 20 | Básico/Starter: até 50 | Pro/Enterprise: até 100 veículos ordenados por valor decrescente.

GET / POST /api/comparar ⭐ Exclusivo para Assinantes

Comparador de Depreciação e Retenção de Valor (12 a 24 Meses):
Permite comparar dois veículos simultaneamente (ex: Toyota Corolla vs Chevrolet Onix ou Honda Civic) e receber em JSON estruturado a curva histórica de desvalorização mês a mês, variação nominal e percentual, além de uma análise de mercado automatizada indicando qual modelo reteve mais valor.

• Aceita códigos FIPE (veiculo1=002182-2&ano1=2024&veiculo2=004451-2&ano2=2014)
• Aceita termos de busca textual (veiculo1=Corolla&veiculo2=Civic)
• Parâmetro opcional: &meses=12 (de 2 a 24 meses históricos).
• Suporta requisições GET (via query string) e POST (via JSON Body).

🔒 Recurso Comercial Exclusivo: Disponível para assinantes dos planos Básico, Starter, Pro e Enterprise. Requer o envio de chave de API ativa via cabeçalho X-API-Key.

curl -X GET "https://fipeapibrasil.com.br/api/comparar?veiculo1=002182-2&ano1=2024&veiculo2=004451-2&ano2=2014&meses=12" -H "X-API-Key: SUA_CHAVE_AQUI"

curl -X POST "https://fipeapibrasil.com.br/api/comparar" -H "X-API-Key: SUA_CHAVE_AQUI" -H "Content-Type: application/json" -d '{ "veiculo1": "002182-2", "ano1": "2024", "veiculo2": "004451-2", "ano2": "2014", "meses": 12 }'

// Requisição via Fetch API (GET ou POST JSON) const res = await fetch('https://fipeapibrasil.com.br/api/comparar', { method: 'POST', headers: { 'X-API-Key': 'SUA_CHAVE_AQUI', 'Content-Type': 'application/json' }, body: JSON.stringify({ veiculo1: '002182-2', ano1: '2024', veiculo2: '004451-2', ano2: '2014', meses: 12 }) }); const { veiculo1, veiculo2, comparativo } = await res.json(); console.log('Menor desvalorização:', comparativo.veiculo_menor_desvalorizacao); console.log('Veredito de Mercado:', comparativo.analise_mercado);

import requests url = "https://fipeapibrasil.com.br/api/comparar" payload = { "veiculo1": "002182-2", "ano1": "2024", "veiculo2": "004451-2", "ano2": "2014", "meses": 12 } headers = { "X-API-Key": "SUA_CHAVE_AQUI", "Content-Type": "application/json" } res = requests.post(url, json=payload, headers=headers) dados = res.json() print("Menor Desvalorização:", dados["comparativo"]["veiculo_menor_desvalorizacao"]) print("Análise de Mercado:", dados["comparativo"]["analise_mercado"])

EXCLUSIVO

Inteligência de Mercado & Mais Vendidos (FENABRAVE)

A FIPE API BRASIL integra oficialmente os dados públicos de emplacamentos e vendas da FENABRAVE (Federação Nacional da Distribuição de Veículos Automotores). Permite cruzar valores da Tabela FIPE com o volume real de vendas e índice de liquidez de mercado em 7 segmentos automotivos no Brasil.

GET /api/mercado/mais-vendidos

Retorna o ranking oficial do Top 20 veículos mais vendidos no Brasil segundo a FENABRAVE com cálculo de market share no top 20, volume total registrado e metadados de acompanhamento. No mês corrente em andamento, os dados contam com revalidação e acompanhamento frequente.

Parâmetros da Consulta (Query Parameters):

Parâmetro	Tipo	Obrigatório	Descrição & Opções
segmento	string	Não (default: `auto`)	`auto` (Automóveis), `comercial` (Comerciais Leves), `motos` (Motos), `caminhoes`, `onibus`, `implementos` ou `todos`.
ano	integer	Não (default: mais recente)	Ano de apuração (ex: `2026`, `2025`, `2024`).
mes	integer	Não (default: mais recente)	Mês de apuração de 1 a 12 (ex: `9` para Setembro).

curl -X GET "https://fipeapibrasil.com.br/api/mercado/mais-vendidos?segmento=auto"

const res = await fetch('https://fipeapibrasil.com.br/api/mercado/mais-vendidos?segmento=auto'); const data = await res.json(); console.log('Líder de Vendas: ' + data.ranking[0].modelo + ' (' + data.ranking[0].unidades + ' unidades)');

import requests url = "https://fipeapibrasil.com.br/api/mercado/mais-vendidos?segmento=auto" res = requests.get(url) data = res.json() print("Top 1:", data["ranking"][0]["modelo"], "-", data["ranking"][0]["unidades"], "emplacamentos")

GET /api/mercado/mais-vendidos/atual

Retorna a fotografia consolidada de todos os 7 segmentos monitorados no mercado brasileiro em uma única requisição. Ideal para dashboards gerenciais, painéis analíticos e acompanhamento simultâneo de carros, picapes, motos e caminhões.

GET /api/mercado/segmentos

Lista os 7 segmentos de mercado homologados pela FENABRAVE com seus respectivos IDs, slugs, ícones representativos e exemplos de rota prontos para consumo na sua aplicação.

GET /api/mercado/historico?modelo={nome}

Retorna a série temporal histórica de vendas mês a mês desde 2024 para o modelo pesquisado. Permite acompanhar a curva de crescimento, estabilidade ou queda de emplacamentos de veículos como VW Polo, Fiat Strada, Chevrolet Onix, Toyota Hilux ou Honda CG 160.

curl -X GET "https://fipeapibrasil.com.br/api/mercado/historico?modelo=POLO"

const res = await fetch('https://fipeapibrasil.com.br/api/mercado/historico?modelo=POLO'); const { historico, total_unidades_acumuladas } = await res.json(); console.log('Total acumulado: ' + total_unidades_acumuladas + ' unidades');

import requests res = requests.get("https://fipeapibrasil.com.br/api/mercado/historico?modelo=POLO") dados = res.json() print("Total de meses mapeados: " + str(dados["total_registros_meses"]))

GET /status?format=json

Endpoint público informativo. A implementação atual contém indicadores fixos e não verifica a saúde de todos os serviços. Não use seus números como comprovação de conectividade com D1, disponibilidade histórica ou SLA.