Preço FIPE pela placa via API, com histórico e ficha técnica

A Tabela FIPE não tem placa. Ela lista preços por marca, modelo, versão e ano-modelo. Para ter o preço de um carro a partir da placa, alguém precisa descobrir qual versão da tabela é aquele carro. A consulta de placa da Simples API faz essa ligação e devolve, na mesma chamada, o código FIPE da versão, o preço do mês, o preço no mesmo mês dos anos anteriores e a ficha técnica, pelos mesmos R$ 0,10.

Este guia mostra por que a ligação é a parte difícil, um exemplo real de resposta, o que fazer quando a versão é provável e quando o bloco não vem.

Resumo

• Endpoint:POST /v1/vehicle/plate (ou POST /v1/ocr/plate com "include_vehicle_info": true, a partir da foto)
• Campo:fipe, ao lado de vehicle_info e battery
• O que vem: versão e código FIPE, preço do mês, histórico anual, ficha técnica e, quando a versão é provável, as alternativas com preço
• Preço: R$ 0,10 por consulta, com ou sem o bloco FIPE na resposta
• Cobertura: medimos em 14 de novembro de 2026, sobre as 5.064 placas diferentes que os clientes consultaram nos 30 dias anteriores. 93% trouxeram o bloco fipe, 71% com a versão exata e 22% com a versão provável

Para quem é

• Revenda e avaliação de usados: a placa do carro de entrada já abre a avaliação com o preço de referência e a curva de preço.
• Seguradora e corretora: a cotação parte do valor FIPE da versão, sem o cliente escolher a versão numa lista.
• Financeira: o valor da garantia sai da placa do veículo financiado.
• Locadora e frota: a depreciação de cada placa é acompanhada ano a ano.
• Marketplace de veículos: o anúncio chega preenchido com a versão, a ficha técnica e o preço de referência.

Por que a placa sozinha não dá o preço

O registro do veículo e a tabela FIPE escrevem a mesma coisa de jeitos diferentes. Três exemplos reais:

A Simples API cruza marca, modelo, ano-modelo, combustível, cilindrada e outros dados do registro com as versões da tabela. Quando só uma versão serve, a ligação é exata. Quando sobram duas ou mais, ela é provável, e as outras vêm em alternatives.

Exemplo real: Jeep Compass Longitude T270 2022

curl-X POST "https://api.simplesapi.com.br/v1/vehicle/plate"\-H"Authorization: Bearer SUA_API_KEY"\-H"Content-Type: application/json"\-d'{"plate": "ABC1D23"}'

O bloco fipe da resposta (placa fictícia, dados reais da versão):

{"fipe":{"level":"exact","code":"017071-2","brand":"Jeep","name":"COMPASS LONG. T270 1.3 TB 4x2 Flex Aut.","model_year":2022,"zero_km":false,"fuel":"Flex","price":112633.0,"price_month":"2026-11","specs":{"trim":"Long.","engine":"T270 1.3 Turbo","fuel_type":"flex","displacement_cc":1332,"power_cv":{"gasolina":176,"etanol":176},"torque_kgfm":{"gasolina":27.53,"etanol":27.53},"transmission":"automatico","gears":6,"drive":"4x2","consumption_city_kml":{"gasolina":10.1,"etanol":7.3},"consumption_highway_kml":{"gasolina":12.1,"etanol":8.6},"length_mm":4404,"width_mm":1819,"height_mm":1628,"wheelbase_mm":2636,"trunk_l":476,"tank_l":55,"body":"suv","seats":5},"price_history":[{"month":"2021-11","price":160521.0},{"month":"2022-11","price":168903.0},{"month":"2023-11","price":148934.0},{"month":"2024-11","price":132904.0},{"month":"2025-11","price":126836.0},{"month":"2026-11","price":112633.0}],"alternatives":[]}}

O histórico conta a história do carro: o Compass 2022 subiu de preço no primeiro ano, chegou a R$ 168.903 em novembro de 2022 e, desde então, caiu 33%. Só no último ano, caiu 11%.

Os campos do bloco

Um price_month antigo quer dizer que a versão saiu da tabela FIPE, e o preço é o último que ela teve.

A ficha técnica

O specs traz só os campos que temos para a versão. Os que faltam não aparecem. Potência, torque e consumo vêm por combustível, como {"gasolina": 176, "etanol": 176}.

Na medição de novembro, entre as placas com bloco fipe, cada campo veio nesta proporção:

A lista completa de chaves e unidades está na documentação da API.

Quando a versão é provável

Às vezes o registro não basta para separar duas versões. Um BMW 320i 2021, por exemplo, pode ser qualquer uma destas três:

{"fipe":{"level":"probable","name":"320iA 2.0 Turbo/ActiveFlex 16V/GP 4p","price":174337.0,"alternatives":[{"name":"320iA Modern/Sport TB 2.0/A.Flex/GP 4p","price":181815.0},{"name":"320iA 2.0 TB M Sport A.Flex/M.Sport 4p","price":199907.0}]}}

(resumido: a resposta traz também o código, o ano e o mês de cada versão)

Entre a versão mais barata e a mais cara são R$ 25.570. Por isso a API não esconde a dúvida:

• Avaliação com uma pessoa: mostre a versão principal e as alternativas, e deixe o avaliador escolher olhando o carro.
• Cotação automática: use só ligações exact ou trabalhe com a faixa entre o menor e o maior preço.

A ficha técnica e o histórico vêm só para a versão principal. As alternativas trazem código, ano, combustível e preço.

Quando o bloco não vem

O campo fipe vem null quando a placa não tem ligação com a tabela FIPE: reboques e semirreboques, veículos que não estão na tabela e placas que ainda estão em análise. A consulta custa o mesmo, e vehicle_info vem normalmente.

Dentro do bloco, price vem null quando a tabela não tem preço para aquele ano e combustível, e price_history vem vazio no zero km, porque a FIPE só lista um ano-modelo como usado depois que ele deixa de ser zero km.

Exemplo de código: avaliação a partir da placa

// Resume o bloco fipe da resposta de POST /v1/vehicle/plate para a tela de avaliaçãofunctionavaliacao(resposta){const fipe = resposta.fipeif(!fipe || fipe.price==null){return{temPreco:false,aviso:'Sem preço FIPE para esta placa: avalie pela versão.'}}const precos =[fipe.price,...fipe.alternatives.map((a)=> a.price)].filter((p)=> p !=null)const historico = fipe.price_historyconst anoPassado = historico.length>=2? historico[historico.length-2].price:nullreturn{temPreco:true,versao: fipe.name,codigoFipe: fipe.code,precoFipe: fipe.price,mes: fipe.price_month,// Faixa de preço quando a versão é provávelfaixa:{menor:Math.min(...precos),maior:Math.max(...precos)},confirmarVersao: fipe.level==='probable',// Variação em 12 meses, em %variacao12Meses: anoPassado ?((fipe.price/ anoPassado -1)*100).toFixed(1):null,curva: historico.map((p)=>({mes: p.month,preco: p.price})),}}

Quanto custa

Uma revenda que avalia 15 carros por dia, em 26 dias de trabalho, gasta cerca de R$ 39 por mês. A conta nova ganha R$ 5 em créditos, o suficiente para 50 consultas de teste.

Sobre o preço FIPE

O preço FIPE é um preço médio de referência, publicado todo mês pela Fundação Instituto de Pesquisas Econômicas. O valor de um carro específico depende do estado, da quilometragem e da região. A Simples API importa a tabela todas as noites, então o mês novo aparece na consulta assim que a FIPE publica. A Simples API não tem vínculo com a FIPE.

Próximos passos

• Crie sua conta em simplesapi.com.br/register e teste com R$ 5 em créditos grátis.
• Veja todos os campos da resposta na documentação da API.
• A mesma consulta traz a bateria indicada para o veículo, com referências Moura e Heliar.
• Usa um agente de IA? A ferramenta lookup_vehicle_by_plate do servidor MCP traz o mesmo bloco FIPE.

FAQ

Dá para consultar a tabela FIPE pela placa? A tabela não tem placa, mas a consulta de placa da Simples API liga a placa à versão da tabela e devolve o código FIPE, o preço do mês e o histórico no campo fipe.

O preço FIPE é o preço de venda do carro? Não. É um preço médio de referência. O valor de um carro específico depende do estado, da quilometragem e da região.

Com que frequência o preço é atualizado? A FIPE publica a tabela uma vez por mês. A Simples API importa a tabela todas as noites, então o preço do mês novo aparece assim que é publicado.

O que fazer quando a versão vem como provável? Mostre a versão principal e as alternativas para alguém escolher olhando o carro, ou use a faixa entre o menor e o maior preço. Em automações que não podem errar a versão, use só as ligações exatas.

Funciona para motos e caminhões? Sim, quando o veículo está na tabela FIPE. Reboques e semirreboques não estão na tabela e vêm com fipe nulo.

Quanto custa consultar o preço FIPE pela placa? R$ 0,10 por consulta, o mesmo preço da consulta de placa sem o bloco FIPE. Pela foto da placa, R$ 0,15.