# FIPE API

> A FIPE API (fipe.api.br) fornece preços médios de veículos da tabela FIPE — carros, motos e caminhões — em JSON via REST. Online desde 2015, gratuita para começar, com sincronização mensal com a tabela FIPE oficial, histórico de preços por código FIPE e download completo em CSV.

Host canônico: https://fipe.api.br. Os dados são derivados da tabela FIPE pública, mantida pela Fundação Instituto de Pesquisas Econômicas; uso por assistentes de IA (busca, respostas e treinamento) é permitido — ver robots.txt.

## Sobre

A "tabela FIPE" é a publicação mensal oficial de preços médios de veículos no mercado brasileiro, usada como referência por seguradoras, bancos e concessionárias. A FIPE API indexa carros, motos e caminhões dessa base e os expõe por código FIPE, marca, modelo e ano, em uma API REST com respostas em JSON.

A API usa banco de dados próprio: todas as requisições acontecem internamente, sem sobrecarregar o Web Service da FIPE, evitando bloqueios por múltiplos acessos. Os dados são sincronizados mensalmente, sempre que a FIPE publica uma nova tabela. O serviço está online desde 2015.

## Páginas principais

- [Início](https://fipe.api.br/): visão geral da API, busca de preço e perguntas frequentes
- [Busca de preço](https://fipe.api.br/busca-de-preco): consulta interativa da tabela FIPE por marca, modelo e ano
- [Planos](https://fipe.api.br/pricing): comparação do plano gratuito com o plano Pro
- [Documentação](https://fipe.api.br/docs/api): referência completa da API REST, com exemplos
- [Status](https://fipe.api.br/status): disponibilidade da API por região nos últimos 90 dias
- [Criar conta](https://fipe.api.br/register): token de acesso gratuito, sem cartão de crédito
- [Termos de uso](https://fipe.api.br/termos-de-uso)

## API REST

Base pública: `https://fipe.parallelum.com.br/api/v2`. Respostas em JSON. Tipos de veículo (`{vehicleType}`): `cars`, `motorcycles`, `trucks`.

Principais endpoints:

- `GET /references` — meses de referência da tabela FIPE
- `GET /{vehicleType}/brands` — marcas por tipo de veículo
- `GET /{vehicleType}/brands/{brandId}/models` — modelos de uma marca
- `GET /{vehicleType}/brands/{brandId}/models/{modelId}/years` — anos disponíveis de um modelo
- `GET /{vehicleType}/brands/{brandId}/years` — anos disponíveis por marca
- Consultas por código FIPE: anos, detalhes do veículo e histórico de preços a partir do código (ex.: `004278-1`) — ver a [documentação](https://fipe.api.br/docs/api) para os caminhos completos

Autenticação é opcional: com um token gratuito (criado em [fipe.api.br/register](https://fipe.api.br/register)) o limite diário aumenta. O token é enviado no cabeçalho da requisição, conforme descrito na documentação.

## Planos e limites

- **Sem autenticação**: 500 requisições por dia (24h)
- **Token gratuito**: 1.000 requisições por dia, sem cartão de crédito
- **Pro (R$ 49,90/mês)**: consultas ilimitadas, acesso a 1 ano de histórico de preços, download completo da tabela em CSV e suporte prioritário — [fipe.api.br/pricing](https://fipe.api.br/pricing)

## Código aberto e suporte

- [Repositório no GitHub](https://github.com/deividfortuna/fipe): projeto de código aberto (MIT) mantido por Deivid Fortuna
- Suporte da comunidade via [issues no GitHub](https://github.com/deividfortuna/fipe/issues); suporte prioritário por email para assinantes do plano Pro

## Conceitos

- "Tabela FIPE" é a publicação mensal oficial de preços de referência; a FIPE API consome essa tabela, não a substitui.
- "Referência" é o mês de publicação FIPE em que um preço foi cotado (ex.: "Julho de 2026").
- "Código FIPE" identifica unicamente um modelo de veículo na tabela FIPE.
- Os preços representam a média nacional para pagamento à vista, e podem variar conforme região, conservação e opcionais do veículo.