Hubs

Anos-modelo e versões de uma família

Hub da família: para cada ano-modelo (0km primeiro, depois do mais novo ao mais antigo) o número de versões e o preço mínimo, máximo e mediano — a curva de preço por idade —, mais cada versão com os anos em que tem preço (cada par versão × ano é uma página de veículo). Família inexistente na marca retorna 404.

Tudo vem do período mais recente da família (ref_year/ref_month): versões e anos-modelo que a FIPE não precifica mais nesse mês ficam de fora (suas páginas continuam respondendo). Uma família defasada responde com o seu último mês, mais antigo que o da tabela.

get/v1/brands/{brand}/families/{family}

Request

  • Base URL: https://api.fipex.com.br
  • URL: https://api.fipex.com.br/v1/brands/{brand}/families/{family}
  • Auth: none declared

Path parameters

brandstring required

Slug da marca (fiat) ou slug real de uma das marcas FIPE que ela une (fiat-21). Compare brand.slug da resposta com o pedido para redirecionar para a URL canônica.

familystring required

Slug da família, único dentro da marca.

Response

Hub da família.

Example response

{
  "data": {
    "brand": {
      "slug": "fiat",
      "name": "Fiat",
      "vehicle_types": [
        "caminhão",
        "carro"
      ],
      "family_count": 38,
      "version_count": 590,
      "make_slugs": [
        "fiat",
        "fiat-21"
      ]
    },
    "slug": "gol",
    "name": "Gol",
    "version_count": 107,
    "years": [
      {
        "year": {
          "value": "2020"
        },
        "version_count": 2,
        "price": {
          "min_cents": 218100,
          "min_formatted": "R$ 2.181,00",
          "max_cents": 5444500,
          "max_formatted": "R$ 54.445,00"
        },
        "median_cents": 7647200,
        "median_formatted": "R$ 76.472,00"
      }
    ],
    "versions": [
      {
        "model_name": "Gol (novo) 1.0 Mi Total Flex 8V 4p",
        "make_slug": "vw-volkswagen",
        "model_slug": "gol-novo-1-0-mi-total-flex-8v-4p",
        "fuel_acronym": "f",
        "fuel_name": "Flex",
        "fipe_code": "005275-2",
        "vehicle_type": "carro",
        "years": [
          {
            "value": "2020"
          }
        ]
      }
    ],
    "ref_year": 2026,
    "ref_month": 10
  }
}

Changes

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