Hubs

Famílias de modelo de uma marca

Hub da marca: suas famílias de modelo com faixa de anos-modelo, número de versões e faixa de preço atual. Aceita também o slug real de uma marca FIPE unida (fiat-21 responde com a marca fiat). Marca desconhecida ou sem veículos com preço retorna 404.

Nenhum agregado dos hubs mistura períodos de referência: cada grupo (marca, família, família-ano) agrega só as versões com preço no seu período mais recente — o mês mais recente da tabela, se alguma versão do grupo tem preço nele. Um grupo sem nenhuma versão no mês mais recente ("defasado": a FIPE deixou de precificá-lo) continua respondendo, agregado só pelo seu próprio último mês, e informa esse ref_year/ref_month mais antigo onde a resposta o tem. As famílias defasadas também são listadas aqui.

Preço zero não conta como preço em nenhum hub (nem em /v1/sitemap-hubs): a FIPE publicou R$ 0 para alguns anos-modelo (ADLY ATV 100, 2012-09). Um grupo cujos únicos preços são zero não existe como hub — responde 404 e fica fora do índice e do sitemap —, e faixas de preço e medianas nunca mostram R$ 0,00. As páginas de veículo desses anos-modelo continuam existindo.

Todos os hubs (e /v1/sitemap-hubs) saem de um retrato do catálogo mantido em memória pela API: mudanças na base aparecem em até 2 minutos.

get/v1/brands/{brand}

Request

  • Base URL: https://api.fipex.com.br
  • URL: https://api.fipex.com.br/v1/brands/{brand}
  • 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.

Response

Hub da marca.

Example response

{
  "data": {
    "brand": {
      "slug": "fiat",
      "name": "Fiat",
      "vehicle_types": [
        "caminhão",
        "carro"
      ],
      "family_count": 38,
      "version_count": 590,
      "make_slugs": [
        "fiat",
        "fiat-21"
      ]
    },
    "families": [
      {
        "slug": "uno",
        "name": "Uno",
        "vehicle_types": [
          "carro"
        ],
        "version_count": 72,
        "first_year": 1985,
        "last_year": 2021,
        "price": {
          "min_cents": 218100,
          "min_formatted": "R$ 2.181,00",
          "max_cents": 5444500,
          "max_formatted": "R$ 54.445,00"
        }
      }
    ]
  }
}

Changes

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