FipeMaster

API histórica FIPE

25 anos de dados FIPE em uma API REST

Acesso programático ao maior histórico de preços FIPE do Brasil, desde janeiro/2001. Construída para seguradoras, fintechs, financeiras e plataformas que precisam fundamentar valor de mercado, depreciação real e benchmarks setoriais. Auth simples por API Key, planos com cota e preço marginal previsíveis.

Gerar minha API Key →Ver endpoints

Planos e preços

Cota dupla: dados (10 endpoints leves de SQL/MV) e IA (laudos gerados por Claude) cobradas separadamente. Base mensal fixa + preço marginal por excedente em cada cota, com cap configurável.

API Starter

R$ 99,00/mês

Para integrações pequenas e provas de conceito

Cota Dados

  • 5.000 requests/mês
  • Excedente: R$ 0,0200/req

Cota IA (laudos)

não incluso — upgrade pra Growth/Scale pra usar /laudo

API Growth

R$ 299,00/mês

Para fintechs e startups com volume médio

Cota Dados

  • 25.000 requests/mês
  • Excedente: R$ 0,0150/req

Cota IA (laudos)

  • 50 laudos/mês
  • Excedente: R$ 1,50/laudo
  • Cap IA: R$ 200,00/mês

API Scale

R$ 999,00/mês

Para seguradoras e plataformas com volume alto

Cota Dados

  • 100.000 requests/mês
  • Excedente: R$ 0,0100/req

Cota IA (laudos)

  • 500 laudos/mês
  • Excedente: R$ 1,00/laudo
  • Cap IA: R$ 1.000,00/mês

Volumes acima de Scale (100 mil+ req/mês) podem fechar contrato customizado, fale com o time comercial via contato@fipemaster.com.br.

Autenticação

Todas as chamadas exigem o header Authorization: Bearer fipe_live_…. Sua chave nasce em /conta/api e é mostrada uma única vez, guarde com segurança. Em caso de comprometimento, revogue e gere uma nova; chaves revogadas retornam 401 imediatamente.

bash
curl -H "Authorization: Bearer fipe_live_xxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://fipemaster.com.br/api/v1/indice?limit=12"

Teste sem cadastro (sandbox)

Para validar a integração antes de gerar sua chave, use a chave demo abaixo. Limitações: 5 req/min por IP, 100/dia total, sem acesso ao /api/v1/laudo (gera custo IA real). Dados são reais.

bash
curl -H "Authorization: Bearer fipe_demo_public_sandbox_key" \
  "https://fipemaster.com.br/api/v1/indice?limit=3"

Erros padrão

  • 400 INVALID_PARAM / INVALID_FIPE, parâmetro inválido
  • 401 UNAUTHENTICATED, chave ausente, malformada ou revogada
  • 402 QUOTA_CAP_EXCEEDED, cap mensal de excedente dados atingido
  • 402 QUOTA_IA_CAP_EXCEEDED, cap mensal de excedente IA atingido (laudos)
  • 403 PLAN_DEACTIVATED, plano associado descontinuado
  • 403 PLAN_DOES_NOT_INCLUDE_AI, plano Starter tentando usar /laudo — upgrade pra Growth+
  • 403 SANDBOX_ENDPOINT_BLOCKED, sandbox tentando /laudo
  • 404 NOT_FOUND, recurso solicitado não existe
  • 429 RATE_LIMITED, limite de req/s atingido — header Retry-After indica quando tentar de novo
  • 500 INTERNAL_ERROR, falha do servidor (registre e tente novamente)

Headers de resposta

  • X-Quota-Type, dados ou ia — qual cota a request descontou
  • X-Quota-Limit / X-Quota-Used, cota mensal e consumo (do tipo da request)
  • X-Quota-Excedente-Centavos, quanto você está pagando além da base no mês corrente
  • X-Quota-Cap-Centavos, limite configurado de excedente mensal (se houver)
  • X-RateLimit-Limit / X-RateLimit-Remaining, limite e tokens restantes do bucket (refill contínuo)
  • X-Plan-Slug, identifica seu plano (starter / growth / scale / sandbox)

Rate limits por plano

  • Starter: 5 req/s sustained, burst 20
  • Growth: 15 req/s sustained, burst 60
  • Scale: 50 req/s sustained, burst 200

Burst esgotado = 429 com Retry-After. Refill contínuo (token bucket), sem janela fixa. Volumes maiores: contrato.

Exemplos por linguagem

Sem SDK oficial — a API é REST padrão sobre HTTPS, qualquer cliente HTTP funciona. Abaixo, o mesmo request (GET /api/v1/depreciacao/001004-9) em 4 stacks comuns.

cURL

bash
curl -fsS \
  -H "Authorization: Bearer fipe_live_xxx" \
  -H "Accept: application/json" \
  "https://fipemaster.com.br/api/v1/depreciacao/001004-9"

Node.js (fetch nativo, Node 18+)

javascript
const res = await fetch(
  "https://fipemaster.com.br/api/v1/depreciacao/001004-9",
  { headers: { Authorization: `Bearer ${process.env.FIPE_API_KEY}` } }
);
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const dados = await res.json();
console.log(`Cota: ${res.headers.get("x-quota-used")}/${res.headers.get("x-quota-limit")}`);
console.log(dados);

Python (requests)

python
import os, requests

r = requests.get(
    "https://fipemaster.com.br/api/v1/depreciacao/001004-9",
    headers={"Authorization": f"Bearer {os.environ['FIPE_API_KEY']}"},
    timeout=15,
)
r.raise_for_status()
print(f"Cota: {r.headers.get('x-quota-used')}/{r.headers.get('x-quota-limit')}")
print(r.json())

PHP (cURL nativo)

php
<?php
$ch = curl_init("https://fipemaster.com.br/api/v1/depreciacao/001004-9");
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER     => ["Authorization: Bearer " . getenv("FIPE_API_KEY")],
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT        => 15,
]);
$res    = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status !== 200) throw new RuntimeException("HTTP $status: $res");
$dados = json_decode($res, true);
print_r($dados);

Postman / Insomnia / OpenAPI: baixe a spec OpenAPI 3.1 em /api/v1/openapi.json e importe pra gerar collection completa, autocompletar e tipos.

Casos de uso reais

Como nossos clientes B2B usam a API. Cada caso aponta os endpoints específicos pra resolver o problema.

Seguradoras — valuation em sinistro

Cias de seguro auto, peritos, casas de avaliação

Justificar valor de indenização baseado no preço FIPE da data exata do sinistro, com auditoria reproduzível.

Endpoints usados

/api/v1/valuation/{fipe} — valor de mercado + depreciação 12/24/36m + posição no segmento
/api/v1/historico/{fipe} — preço mês a mês desde 2001 pra contestações em juízo
/api/v1/forecast/{fipe}?ano= — projeção P10/P50/P90 em 3/6/12m — sinistro com diferimento ou indenização escalonada

Financeiras de crédito automotivo

Bancos, fintechs, cooperativas que financiam carros usados

Calcular LTV (loan-to-value) realista e residual em 24/36/48m antes de aprovar crédito.

Endpoints usados

/api/v1/retencao/{fipe} — score 0-100 de retenção — alimenta política de teto de financiamento
/api/v1/volatilidade/{fipe} — incerteza do residual — usado em provision de risco
/api/v1/depreciacao/{fipe} — curva histórica pra modelar valor futuro
/api/v1/forecast/{fipe}?ano= — residual projetado P10/P50/P90 em 12m — provision de risco mais agudo que CAGR histórico

Concessionárias / lojas multimarca

Grupos de revenda, plataformas de venda online

Precificar veículo entrante (troca) e identificar janela ótima de venda do estoque.

Endpoints usados

/api/v1/historico/{fipe} — comparar preço pedido com mediana 12m
/api/v1/sazonalidade?categoria= — melhor mês pra anunciar cada segmento (Market Timing)
/api/v1/ranking?tipo=retencao — ranking de modelos que vendem mais rápido (proxy de liquidez)

Imprensa / data journalism

Sites automotivos, agências de notícia, redatores especializados

Gerar conteúdo factual sobre tendência do mercado, sazonalidade, modelos em alta/queda.

Endpoints usados

/api/v1/indice?desde=&ate= — índice geral mensal pra gráficos de tendência
/api/v1/ranking?tipo= — rankings de top valorização e maior perda
/api/v1/sazonalidade — matérias de timing ('compre seu hatch em fevereiro')

Laudo IA white-label

Marketplaces de usados, apps de compra-venda peer-to-peer

Oferecer 'parecer FipeMaster' como feature de confiança pro comprador final, sem desenvolver IA interna.

Endpoints usados

/api/v1/laudo/{fipe} — veredicto COMPRAR/AGUARDAR/EVITAR + nota + análise — exibido como widget no anúncio
/api/v1/tco/{fipe}?uf= — estimativa de custo total mensal pro comprador planejar

Análise de risco — fundos / aluguel

Locadoras (Movida, Localiza), fundos de fleet leasing

Decidir composição de frota baseada em volatilidade de revenda no segmento e horizonte de uso.

Endpoints usados

/api/v1/volatilidade/{fipe} — comparar risco de cada modelo vs peers do segmento
/api/v1/tco/{fipe}?anos=5 — TCO de 5 anos com IPVA + seguro + depreciação real por UF
/api/v1/retencao/{fipe} — modelo que retém mais valor = menor custo de propriedade efetivo

Endpoints

GET/api/v1/historico/{fipe}

Série histórica completa de preços FIPE para um veículo. Cada ponto traz mês, preço, variação mensal e variação acumulada desde o primeiro registro.

Parâmetros

NomeTipoObservação
fipestring (path)Código FIPE no formato '001004-9'

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/historico/001004-9"

Resposta

json
{
  "veiculo": {
    "codigo_fipe": "001004-9",
    "marca": "Fiat",
    "modelo": "Uno Mille 1.0",
    "ano_modelo": "2010",
    "combustivel": "Gasolina"
  },
  "meses": 196,
  "serie": [
    {
      "mes_referencia": "outubro 2009",
      "cod_referencia": 100,
      "preco": 24300.0,
      "preco_anterior": null,
      "variacao_mensal_pct": null,
      "variacao_acumulada_pct": 0
    },
    ...
  ]
}
GET/api/v1/depreciacao/{fipe}

Perfil analítico de depreciação: CAGR anualizado, volatilidade mensal, melhor e pior mês históricos. Saída condensada, ideal para regras de subscrição e cálculo de valor justo.

Parâmetros

NomeTipoObservação
fipestring (path)Código FIPE

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/depreciacao/001004-9"

Resposta

json
{
  "veiculo": { "codigo_fipe": "001004-9", "marca": "Fiat", ... },
  "preco":   { "atual": 19500, "inicial": 24300, "mes_atual": "maio 2026" },
  "depreciacao": {
    "meses_historico": 196,
    "variacao_acumulada_pct": -19.75,
    "cagr_anual_pct": -1.23,
    "volatilidade_mensal_pct": 1.4
  },
  "sazonalidade": {
    "melhor_mes": "março",
    "melhor_variacao_pct": -2.1,
    "pior_mes": "novembro",
    "pior_variacao_pct": 1.8
  }
}
GET/api/v1/indice

Índice agregado do mercado automotivo brasileiro mês a mês. Preço médio, mediana, mínimo, máximo, total de versões e variação mensal %. Cobre 25 anos.

Parâmetros

NomeTipoObservação
desdestring (YYYY-MM)Filtra a partir deste mês inclusivo. Opcional.
atestring (YYYY-MM)Filtra até este mês inclusivo. Opcional.
limitintegerRetorna apenas os últimos N meses. Opcional.

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/indice?desde=2024-01&ate=2026-05"

Resposta

json
{
  "meses": 29,
  "filtro": { "desde": "2024-01", "ate": "2026-05", "limit": null },
  "indice": [
    {
      "cod_referencia": 300,
      "mes_referencia": "janeiro 2024",
      "total_versoes": 18420,
      "preco_medio": 86500.12,
      "mediana": 64200.0,
      "preco_minimo": 1800.0,
      "preco_maximo": 4200000.0,
      "variacao_media_mensal_pct": 0.42
    },
    ...
  ]
}
GET/api/v1/ranking

Top 20 veículos por retenção de valor ou depreciação nos últimos 5 anos. Útil para alimentar dashboards setoriais e benchmarking de portfólio.

Parâmetros

NomeTipoObservação
tipodepreciacao | retencaoDefault: depreciacao (top 20 que mais perderam valor em 5 anos).

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/ranking?tipo=retencao"

Resposta

json
{
  "tipo": "retencao",
  "janela_meses": 60,
  "total": 20,
  "ranking": [
    {
      "posicao": 1,
      "codigo_fipe": "022039-1",
      "marca": "Toyota",
      "modelo": "Hilux SRX",
      "ano_modelo": "2021",
      "combustivel": "Diesel",
      "preco_atual": 318000,
      "preco_5anos_atras": 295000,
      "variacao_pct": 7.8
    },
    ...
  ]
}
GET/api/v1/valuation/{fipe}

Valuation report estruturado para sinistro, perícia ou justificativa de valor. Retorna valor atual, valores em 12/24/36 meses atrás, depreciação anualizada, volatilidade, percentil dentro do segmento (categoria + combustível) e tendência últimos 3 meses. Saída determinística, mesma referência produz mesmo payload (auditável).

Parâmetros

NomeTipoObservação
fipestring (path)Código FIPE do veículo

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/valuation/001004-9"

Resposta

json
{
  "veiculo": {
    "codigo_fipe": "001004-9",
    "marca": "Fiat", "modelo": "Uno Mille 1.0",
    "ano_modelo": "2010", "combustivel": "Gasolina",
    "categoria": "HATCH"
  },
  "referencia": { "mes_referencia": "maio de 2026", "cod_referencia": 333 },
  "valor": {
    "atual":  19500,
    "em_12m": 21800,
    "em_24m": 24100,
    "em_36m": 26900
  },
  "depreciacao": {
    "pct_12m": -10.5,
    "pct_24m": -19.1,
    "pct_36m": -27.5,
    "cagr_anual_pct": -8.2,
    "volatilidade_mensal_pct": 1.4
  },
  "posicao_segmento": {
    "percentil_preco": 32,
    "total_no_segmento": 187,
    "descricao": "HATCH a Gasolina"
  },
  "tendencia_3m": { "pct": -1.2, "direcao": "queda" }
}
GET/api/v1/tco/{fipe}

Custo Total de Propriedade (TCO), calcula depreciação real (FIPE), IPVA por UF, seguro estimado, combustível (km/ano × consumo × preço), manutenção projetada e licenciamento/DPVAT para N anos de posse. Determinístico, útil em análise em lote de frota ou simulação financeira.

Parâmetros

NomeTipoObservação
fipestring (path)Código FIPE do veículo
ufstring (query)Sigla UF, afeta alíquota IPVA. Obrigatório
km_anoint (query)Km/ano estimado. 1 a 200.000. Obrigatório
anosint (query)Anos de posse. 1, 2, 3, 4, 5, 7 ou 10. Default 5

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/tco/001004-9?uf=SP&km_ano=15000&anos=5"

Resposta

json
{
  "veiculo": {
    "codigo_fipe": "001004-9",
    "marca": "Fiat", "modelo": "Uno Mille 1.0",
    "ano_modelo": "2010", "combustivel": "Gasolina",
    "categoria": "HATCH",
    "valor_fipe": 19500
  },
  "premissas": {
    "uf": "SP", "km_ano": 15000, "anos_posse": 5,
    "ipva_aliquota_pct": 4.00,
    "preco_combustivel_brl": 6.00,
    "consumo_km_l_estimado": 13,
    "seguro_pct_anual": 3.0,
    "manutencao_anual_base": 2200,
    "licenciamento_dpvat": 220
  },
  "por_ano": [
    { "ano": 1, "valor_inicio_ano": 19500, "depreciacao": 1599, "ipva": 780, "seguro": 562, "combustivel": 6923, "manutencao": 2420, "licenciamento_dpvat": 220, "total": 12504 },
    { "ano": 2, "valor_inicio_ano": 17901, "depreciacao": 1468, "ipva": 716, "seguro": 516, "combustivel": 6923, "manutencao": 2640, "licenciamento_dpvat": 220, "total": 12483 }
    // ... ano 3, 4, 5
  ],
  "totais": {
    "depreciacao_total":       7115,
    "ipva_total":              3489,
    "seguro_total":            2521,
    "combustivel_total":      34615,
    "manutencao_total":       14520,
    "licenciamento_total":     1100,
    "custo_operacional_total": 56245,
    "custo_total_propriedade": 63360,
    "custo_por_km":            0.84,
    "custo_mensal_medio":      1056
  },
  "origens": {
    "depreciacao":   "real",
    "ipva":          "real",
    "seguro":        "estimativa",
    "combustivel":   "estimativa",
    "manutencao":    "estimativa",
    "licenciamento": "real"
  }
}
GET/api/v1/retencao/{fipe}Novo

Score de retenção de valor (0-100) por veículo. Combina CAGR anual de preço (50% peso), volatilidade mensal (30%) e posição dentro do segmento de preço (20%). Útil em decisão de crédito automotivo (LTV, residual), pricing de seguro e troca em concessionária. Veículo precisa de ≥24 meses de histórico FIPE.

Parâmetros

NomeTipoObservação
fipestring (path)Código FIPE do veículo

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/retencao/001004-9"

Resposta

json
{
  "codigo_fipe": "001004-9",
  "veiculo": {
    "marca": "Fiat", "modelo": "Uno Mille 1.0",
    "ano_modelo": 2010, "combustivel": "Gasolina"
  },
  "score": 62,
  "faixa_preco": "Até R$ 50k",
  "cagr_anual_pct": -8.20,
  "volatilidade_pct": 1.40,
  "variacao_total_pct": -41.5,
  "preco_atual": 19500,
  "preco_inicial": 33310,
  "n_meses_historico": 192
}
GET/api/v1/volatilidade/{fipe}Novo

Volatilidade mensal do preço (STDDEV das variações), com decomposição sistêmica (movimento conjunto do peer group = categoria × faixa de preço) vs idiossincrática (excedente do modelo). Inclui z-score vs peers e classificação amigável (baixa/média/alta/extrema). Útil pra análise de risco em revenda de curto prazo.

Parâmetros

NomeTipoObservação
fipestring (path)Código FIPE do veículo

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/volatilidade/001004-9"

Resposta

json
{
  "codigo_fipe": "001004-9",
  "veiculo": { "marca": "Fiat", "modelo": "Uno Mille 1.0" },
  "volatilidade_pct": 1.40,
  "classificacao": "media",
  "z_score": -0.21,
  "categoria_segmento": "HATCH",
  "faixa_segmento": "ate-50k",
  "peers_count": 124,
  "vol_sistemica_pct": 1.55,
  "vol_idiossincratica_pct": -0.15
}
GET/api/v1/sazonalidadeNovo

Market Timing Score por segmento: em qual mês do ano cada (categoria × faixa de preço) historicamente é mais barato/caro. Útil pra concessionária planejar promoção sazonal, locadora escolher janela de compra de frota, imprensa especializada gerar data stories de timing. Output cobre ~50 segmentos. Filtros opcionais limitam a lista.

Parâmetros

NomeTipoObservação
categoriastring (query)Opcional. Nome da categoria (ex: 'Hatch', 'SUV'). Case-insensitive
faixa_precostring (query)Opcional. 'ate-50k' | '50-100k' | '100-200k' | '200-500k' | '500k+'

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/sazonalidade?categoria=SUV&faixa_preco=100-200k"

Resposta

json
{
  "total": 1,
  "filtros": { "categoria": "SUV", "faixa_preco": "100-200k" },
  "segmentos": [
    {
      "categoria": "SUV",
      "faixa_preco": "100-200k",
      "faixa_label": "R$ 100k–200k",
      "amplitude_pp": 4.2,
      "total_amostras": 18420,
      "melhor_mes": { "mes_num": 2,  "variacao_pct": -1.8 },
      "pior_mes":   { "mes_num": 11, "variacao_pct":  2.4 },
      "serie_mensal": [
        { "mes_num": 1,  "variacao_pct":  0.4 },
        { "mes_num": 2,  "variacao_pct": -1.8 },
        ...
      ]
    }
  ]
}
GET/api/v1/laudo/{fipe}NovoCota IA

Laudo de Compra com IA. Veredicto COMPRAR AGORA / AGUARDAR / EVITAR + nota 0-10 + análise textual estruturada, gerado por Claude sobre 25 anos de FIPE + sazonalidade + sinal de bolha do segmento. Cada chamada consome 1 unidade do plano API + custo proporcional dos tokens Claude. Recomendamos tier Growth ou superior — chamadas levam até ~30s e Starter tem cota baixa. Sem cache: cada geração é fresh (caller pode armazenar localmente).

Parâmetros

NomeTipoObservação
fipestring (path)Código FIPE do veículo

Exemplo (curl)

bash
curl -H "Authorization: Bearer fipe_live_..." \
  "https://fipemaster.com.br/api/v1/laudo/001004-9"

Resposta

json
{
  "veredicto": "AGUARDAR",
  "titulo": "Bom histórico, mas preço acima da média típica",
  "nota": 6.2,
  "resumo": "Modelo com depreciação controlada e oscilação baixa, mas o preço atual está cerca de 8% acima da média histórica do próprio veículo. Vale esperar uma queda nos próximos 2-3 meses antes de fechar negócio.",
  "positivos": [
    "Depreciação anual moderada (~5% ao ano)",
    "Preço pouco oscilante mês a mês",
    "Liquidez alta no mercado de usados"
  ],
  "negativos": [
    "Preço atual 8% acima da média histórica",
    "Segmento HATCH em leve alta nos últimos 3 meses"
  ],
  "melhor_momento": "Historicamente fevereiro e março são os meses mais baratos para hatchbacks populares — espere ~6 semanas.",
  "analise": "Parágrafo 1...\n\nParágrafo 2...\n\nParágrafo 3...",
  "veiculo": {
    "marca": "Fiat", "modelo": "Uno Mille 1.0",
    "ano_modelo": "2010", "combustivel": "Gasolina",
    "codigo_fipe": "001004-9",
    "preco_atual": 19500,
    "mes_atual": "maio de 2026",
    "meses_historico": 192,
    "cagr_anual_pct": -5.2,
    "volatilidade_mensal_pct": 1.4,
    "pct_vs_mediana": 8.1
  },
  "bolha": null,
  "fonte_acesso": "api"
}

Perguntas frequentes

Dúvidas comuns de integradores. Não encontrou a sua? Fale com o time comercial.

Como começar a usar a API FIPE sem cadastro?
Use a chave sandbox pública fipe_demo_public_sandbox_key no header Authorization: Bearer. Limitada a 5 req/min por IP e bloqueia /api/v1/laudo (que gera custo de IA real). Os dados retornados são reais. Para acesso completo, crie uma chave em /conta/api.
Qual a diferença entre cota de dados e cota IA?
A cota de dados (Starter: 5.000/mês, Growth: 25.000, Scale: 100.000) cobre 9 endpoints leves: histórico, depreciação, índice, ranking, valuation, TCO, retenção, volatilidade, sazonalidade. A cota IA é separada e cobre apenas /api/v1/laudo — gerado pelo Claude AI. Growth inclui 50 laudos/mês, Scale 500. Plano Starter não tem acesso a IA — upgrade pra Growth.
A API tem rate limit?
Sim, token bucket por chave com refill contínuo. Starter: 5 req/s sustained + burst 20. Growth: 15 req/s + burst 60. Scale: 50 req/s + burst 200. Sandbox compartilhada: rate limit por IP em vez de por chave (~5 req/min).
Existe SDK oficial em Python, Node ou outras linguagens?
Não há SDK oficial — a API é REST padrão sobre HTTPS com JSON. Qualquer cliente HTTP funciona. A documentação inclui exemplos em cURL, Node 18+ (fetch nativo), Python (requests) e PHP (cURL). OpenAPI 3.1 spec em /api/v1/openapi.json para gerar SDK via openapi-generator ou importar no Postman/Insomnia.
Como funciona a cobrança do excedente?
Cobrança usage-based: base mensal fixa (R$ 99 / R$ 299 / R$ 999 dependendo do plano) + preço marginal por request acima da cota incluída. Você pode configurar um cap mensal de excedente para garantir previsibilidade — chamadas acima do cap retornam HTTP 402 até o próximo ciclo. Excedente cobrado via charge único ASAAS no fim do mês.
Quais setores podem usar a API FipeMaster?
Principalmente seguradoras (valuation em sinistro auto), financeiras de crédito automotivo (LTV e residual em financiamento), concessionárias e plataformas de revenda (precificação de troca, identificação de janela ótima de venda), marketplaces de usados (laudo white-label como feature de confiança), locadoras (composição de frota baseada em volatilidade e TCO) e imprensa especializada (data journalism com índices oficiais).
Os dados são oficiais da Tabela FIPE?
Sim. Nosso scraper coleta mensalmente direto da FIPE oficial desde 2001 — são 36 milhões de registros históricos que você não encontra em nenhuma outra fonte programática. Atualização entre dia 5 e 10 de cada mês, logo após a publicação oficial.

Versionamento e mudanças

Esta é a versão v1 da API. Alterações que quebrem o contrato (renomes, remoções, mudanças de tipo) só acontecem em uma nova major (/api/v2). Campos novos podem ser adicionados em v1 sem aviso, então seu parser deve ignorar campos desconhecidos.

O dataset é atualizado mensalmente pelo nosso scraper logo após a publicação oficial da FIPE, normalmente entre o dia 5 e 10 do mês. Não há latência intra-mês: dentro do mesmo período de referência os preços não mudam.