Começando

Quickstart

Da criação da chave à sua primeira resposta em menos de 5 minutos.

1. Pegue sua API key

Acesse /app/keys e clique em Criar chave. Copie e guarde — a chave completa só aparece uma vez.

2. Faça uma busca

Liste 5 Toyota Corollas no catálogo:

curl -X GET "https://api.fipia.com.br/v1/vehicles/search?brand=Toyota&model=Corolla&limit=5" \
  -H "Authorization: Bearer fa_live_SUA_CHAVE"

3. Pegue ficha técnica

Use o id retornado:

curl -X GET "https://api.fipia.com.br/v1/vehicles/uuid-do-veiculo" \
  -H "Authorization: Bearer fa_live_SUA_CHAVE"

4. Compare dois veículos

curl -X POST "https://api.fipia.com.br/v1/vehicles/compare" \
  -H "Authorization: Bearer fa_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"ids":["uuid-1","uuid-2"]}'

5. Próximos passos

match-intent — recomendação por linguagem natural
MCP — conecte direto no Claude Desktop, Cursor ou n8n
Playground — teste sem código

# Dica: use o header de resposta para monitorar quota
x-credits-used: 1
x-credits-remaining: 999