Pular para o conteúdo
EntrarCriar conta
Ver .md Abrir no Claude Abrir no ChatGPT

API de Placa e FIPE: início rápido

A API do Placa & FIPE recebe a placa de um veículo brasileiro e devolve, em um JSON padronizado, marca, modelo, versão, ano, cor, combustível, município, UF, situação e o valor da Tabela FIPE do mês.

  • URL base: https://api.placaefipe.com.br/v1
  • Formato: JSON (UTF-8), nomes de campos em snake_case e português
  • Autenticação: Authorization: Bearer pf_live_...
  • Preço: 1 crédito por placa encontrada. Placa não encontrada não é cobrada.
  • Grátis: 10 consultas ao criar a conta, sem cartão.

Usa Claude Code, Cursor, Gemini CLI ou Google Antigravity? Copie as instruções prontas em Integração com IA e deixe a IA fazer a integração.

1. Crie a conta e gere a chave

  1. Crie a conta em placaefipe.com.br/criar-conta.
  2. No painel, clique em Gerar chave de API.
  3. Guarde a chave numa variável de ambiente do servidor:
bash
PLACAEFIPE_API_KEY=pf_live_sua_chave_aqui

A chave aparece inteira uma única vez. Se perder, gere outra e revogue a antiga.

2. Faça a primeira consulta

bash
curl https://api.placaefipe.com.br/v1/placas/INT8C36 \
  -H "Authorization: Bearer $PLACAEFIPE_API_KEY"

3. Leia a resposta

json
{
  "placa": "INT8C36",
  "placa_antiga": "INT8236",
  "marca": "VW",
  "modelo": "CROSSFOX",
  "versao": "CROSSFOX 1.6 Mi Total Flex 8V 5p",
  "ano_fabricacao": 2007,
  "ano_modelo": 2007,
  "cor": "Prata",
  "combustivel": "Alcool / Gasolina",
  "municipio": "São Leopoldo",
  "uf": "RS",
  "situacao": "Sem restrição",
  "fipe": {
    "codigo": "005225-6",
    "valor": 28799.0,
    "valor_texto": "R$ 28.799,00",
    "referencia": "novembro de 2026",
    "versoes": []
  },
  "consulta": { "id": "cns_7Hq2LmXa9P", "creditos_restantes": 989, "cobrada": true, "cache": false }
}

A resposta completa, campo a campo, está em Consultar placa.

Regras importantes

  • Chame a API só do seu servidor (backend, rota de API, edge function). Nunca coloque a chave no front-end, no app ou no repositório.
  • Não há dados do proprietário. Nome, CPF e endereço do dono não são retornados (LGPD).
  • A FIPE vem sempre que existir. Quando a placa não define a versão exata, fipe.versoes traz a lista de versões com o valor de cada uma. Veja FIPE.

Próximos passos

  • Autenticação: formatos aceitos da chave e boas práticas.
  • Exemplos de código: Node.js, Next.js, Python, PHP, Go e n8n.
  • Servidor MCP: use a consulta direto no Claude, Cursor, Gemini e Antigravity.
  • Erros: todos os códigos e o que fazer em cada um.
  • OpenAPI: especificação para gerar clientes e importar no Postman.