Rankings

Relatório mensal da Tabela FIPE

Como a Tabela FIPE se moveu em um mês de referência, comparado ao mês civil anterior, por tipo de veículo (carro, moto, caminhão):

  • Resumo: páginas de veículo precificadas no mês (priced_count); das que também tinham preço no mês anterior (compared_count), quantas subiram, caíram ou ficaram iguais, e a variação mediana. Página de veículo = versão não mesclada × combustível da versão × ano-modelo (0 km incluso), a mesma unidade das URLs /preco/.... Preço zero (a FIPE publicou R$ 0 em 2012-09 para a ADLY ATV 100) conta como sem preço nos dois meses, em todo o relatório: um 0 km que passa a R$ 0 entra em zero_km_removed.
  • Maiores altas e quedas: variação = (preço do mês − preço do mês anterior) ÷ preço do mês anterior, só para páginas precificadas nos dois meses. Cada versão aparece no máximo uma vez por lista, no ano-modelo que mais variou; empate → ano mais novo. Não há filtro de "anomalia": de 2022 a 2026 nenhuma variação de 15% ou mais se desfez no mês seguinte — saltos grandes são reprecificações da FIPE que persistem, e a lista os mostra como a FIPE os publicou.
  • Novas versões (new_versions): versões publicadas pela FIPE pela primeira vez no mês, com os anos em que aparecem (quase sempre 0 km + ano-modelo corrente).
  • Saíram do 0 km (zero_km_removed): versões que tinham preço 0 km no mês anterior e não têm mais — a FIPE deixou de cotá-las como novas (em ~2% dos casos o preço 0 km volta depois). A FIPE quase nunca remove uma versão inteira (46 vezes em toda a série, nenhuma desde 2024-10): os anos-modelo seguem precificados.

Sem year/month, usa o mês mais recente. Há relatório para todo mês de 2010-04 em diante cujo mês civil anterior está na base; fora disso, 404. A FIPE publicou as tabelas de 2001 a 2005 depois da de 2010-03, com números de referência (fipe_id) maiores; até 2010-03, "primeira aparição" (menor fipe_id) deixa de significar primeira no tempo. Lacunas na numeração da FIPE (2017-03 é 207, 2017-04 é 211) não importam: o mês comparado é sempre o mês civil anterior. A API guarda em memória os preços dos últimos meses lidos (até 2 minutos): ~20-35 ms por resposta, ~120-180 ms quando precisa lê-los do banco.

get/v1/reports/monthly

Request

  • Base URL: https://api.fipex.com.br
  • URL: https://api.fipex.com.br/v1/reports/monthly
  • Auth: none declared

Query parameters

yearinteger

Ano do mês de referência; exige month.

monthinteger

Mês de referência (1-12); exige year.

vehicle_type'carro' | 'moto' | 'caminhao'

Restringe a um tipo (slug de /v1/vehicle-types).

limitinteger

Tamanho de cada lista de altas e de quedas.

Response

Relatório do mês.

Example response

{
  "data": {
    "ref_year": 2026,
    "ref_month": 10,
    "previous_ref_year": 2026,
    "previous_ref_month": 9,
    "sections": [
      {
        "summary": {
          "priced_count": 29917,
          "compared_count": 29831,
          "up_count": 6743,
          "down_count": 22737,
          "unchanged_count": 351,
          "median_change_pct": -0.0111006
        },
        "risers": [
          {
            "version": {
              "model_name": "SLS-63 AMG 6.2 8V Black Series Automático",
              "make_slug": "mercedes-benz-39",
              "model_slug": "sls-63-amg-6-2-8v-black-series-aut",
              "fuel_acronym": "g",
              "fuel_name": "Gasolina",
              "fipe_code": "021303-9",
              "vehicle_type": "carro",
              "brand_slug": "mercedes-benz",
              "brand_name": "Mercedes-Benz",
              "family_slug": "sls",
              "family_name": "SLS"
            },
            "year": {
              "value": "2020"
            },
            "previous_price_cents": 149331100,
            "previous_formatted_price": "R$ 1.493.311,00",
            "price_cents": 176552100,
            "formatted_price": "R$ 1.765.521,00",
            "change_pct": 0.1822862
          }
        ],
        "fallers": [
          {
            "version": {
              "model_name": "SLS-63 AMG 6.2 8V Black Series Automático",
              "make_slug": "mercedes-benz-39",
              "model_slug": "sls-63-amg-6-2-8v-black-series-aut",
              "fuel_acronym": "g",
              "fuel_name": "Gasolina",
              "fipe_code": "021303-9",
              "vehicle_type": "carro",
              "brand_slug": "mercedes-benz",
              "brand_name": "Mercedes-Benz",
              "family_slug": "sls",
              "family_name": "SLS"
            },
            "year": {
              "value": "2020"
            },
            "previous_price_cents": 149331100,
            "previous_formatted_price": "R$ 1.493.311,00",
            "price_cents": 176552100,
            "formatted_price": "R$ 1.765.521,00",
            "change_pct": 0.1822862
          }
        ],
        "new_versions": [
          {
            "version": {
              "model_name": "SLS-63 AMG 6.2 8V Black Series Automático",
              "make_slug": "mercedes-benz-39",
              "model_slug": "sls-63-amg-6-2-8v-black-series-aut",
              "fuel_acronym": "g",
              "fuel_name": "Gasolina",
              "fipe_code": "021303-9",
              "vehicle_type": "carro",
              "brand_slug": "mercedes-benz",
              "brand_name": "Mercedes-Benz",
              "family_slug": "sls",
              "family_name": "SLS"
            },
            "years": [
              {
                "value": "2020"
              }
            ],
            "price_cents": 22592000,
            "formatted_price": "R$ 225.920,00"
          }
        ],
        "zero_km_removed": [
          {
            "version": {
              "model_name": "SLS-63 AMG 6.2 8V Black Series Automático",
              "make_slug": "mercedes-benz-39",
              "model_slug": "sls-63-amg-6-2-8v-black-series-aut",
              "fuel_acronym": "g",
              "fuel_name": "Gasolina",
              "fipe_code": "021303-9",
              "vehicle_type": "carro",
              "brand_slug": "mercedes-benz",
              "brand_name": "Mercedes-Benz",
              "family_slug": "sls",
              "family_name": "SLS"
            },
            "years": [
              {
                "value": "2020"
              }
            ],
            "price_cents": 22592000,
            "formatted_price": "R$ 225.920,00"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.