Documentação da API FIPE
Consultas autenticadas à base FIPE local do CentralMotor. A consulta exige token e retorna JSON. Esta é uma cópia de dados com referência 2026-11, não uma consulta em tempo real à FIPE.
Autenticação
Use HTTPS e envie o token somente no cabeçalho Authorization: Bearer SEU_TOKEN. Não inclua o token em links, parâmetros de URL, logs ou páginas públicas.
curl -H 'Authorization: Bearer SEU_TOKEN' \\ 'https://centralmotor.com.br/fipe/api.php?recurso=marcas&tipo=carro&q=volks'
Endpoints GET
| recurso | Parâmetros obrigatórios | Descrição |
|---|---|---|
marcas | tipo, q (mín. 2 caracteres) | Busca marcas pelo nome |
anos | tipo, marca | Lista anos disponíveis |
modelos | tipo, marca, ano, q (mín. 3 caracteres) | Pesquisa modelos no ano escolhido |
preco | tipo, marca, ano, codigo_fipe | Consulta valores (combustivel opcional) |
Tipos aceitos: carro, moto, caminhao. Informe marca exatamente como veio de marcas. Para zero-km, use ano=0 quando disponível na lista de anos. codigo_fipe tem formato 000000-0.
Exemplos de fluxo
GET /fipe/api.php?recurso=marcas&tipo=carro&q=volks GET /fipe/api.php?recurso=anos&tipo=carro&marca=VW%20-%20VolksWagen GET /fipe/api.php?recurso=modelos&tipo=carro&marca=VW%20-%20VolksWagen&ano=2010&q=passat GET /fipe/api.php?recurso=preco&tipo=carro&marca=VW%20-%20VolksWagen&ano=2010&codigo_fipe=000000-0
O código FIPE no último exemplo é ilustrativo. Utilize um código real devolvido por modelos.
Resposta
{"data":[{"nome":"VW - VolksWagen"}],"count":1,"reference":"2026-11","limit":15}
Respostas de erro contêm um campo error. Códigos usuais: 400 parâmetros inválidos, 401 token inválido ou ausente, 404 recurso desconhecido, 405 método não permitido, 429 limite excedido, 503 indisponibilidade temporária.
Limites
| Período | Token | IP |
|---|---|---|
| Minuto | 12 | 25 |
| Hora | 80 | 150 |
| Dia | 300 | 600 |
O servidor pode aplicar limites adicionais antes da autenticação. A busca de modelos retorna até 15 resultados. Ao receber 429, respeite o cabeçalho Retry-After.
A referência da base é fixa em novembro de 2026. Valores não devem ser apresentados como cotação em tempo real. O serviço é disponibilizado para buscas pontuais e pode exigir autorização para uso comercial.