---
title: "Todas as URLs de hub, para sitemaps"
method: GET
path: "/v1/sitemap-hubs"
tags: ["Hubs"]
---

# Todas as URLs de hub, para sitemaps

`GET /v1/sitemap-hubs`

## Request

- Base URL: `https://api.fipex.com.br`
- URL: `https://api.fipex.com.br/v1/sitemap-hubs`
- Auth: none declared

Árvore marca → família → ano-modelo com todos os hubs, cada nível com o
período de referência (FIPE) mais recente entre seus preços — o
`<lastmod>` — e o número de versões com preço nesse período. Hubs com
uma única versão são "finos": pule-os no sitemap. Hubs defasados (com
`ref_year`/`ref_month` anterior ao mês mais recente da tabela)
continuam respondendo, mas não refletem a tabela atual: deixe-os de
fora do sitemap e do índice. Resposta única, sem paginação (~16,5 mil
família-anos; ~1,7 MB em JSON, ~320 KB em protobuf).

## Response `200`

Hubs.

- ListSitemapHubsResponse
  - `data` HubSitemapBrand[], required
    - `slug` string, required
    - `version_count` integer, required: Versões FIPE (modelos) distintas com preço em `ref_year`/`ref_month`.
    - `ref_year` integer, required: Período de referência mais recente entre os preços do hub (o `<lastmod>`).
    - `ref_month` integer, required
    - `families` HubSitemapFamily[], required
      - `slug` string, required
      - `version_count` integer, required: Versões FIPE (modelos) distintas com preço em `ref_year`/`ref_month`.
      - `ref_year` integer, required: Período de referência mais recente entre os preços do hub (o `<lastmod>`).
      - `ref_month` integer, required
      - `years` HubSitemapYear[], required: 0km primeiro, depois do mais novo ao mais antigo.
        - `year` YearOption, required: Representa um ano disponível para um modelo. Cada opção é auto-descritiva: `value` é o seletor canônico que pode ser enviado diretamente em `/v1/prices?year=<value>`.
          - `value` string, required: Seletor canônico do ano. `"2020"` para um ano-modelo, `"zero"` para um veículo 0km/novo. Use este valor em `year=` nos endpoints de preço.
          - `is_zero_km` boolean, required: `true` quando a opção é o veículo 0km/novo (`value == "zero"`); `false` para um ano-modelo concreto. Discriminador para ordenar e rotular sem precisar interpretar `value`.
        - `version_count` integer, required: Versões FIPE (modelos) distintas com preço em `ref_year`/`ref_month`.
        - `ref_year` integer, required: Período de referência mais recente entre os preços do hub (o `<lastmod>`).
        - `ref_month` integer, required

## Other responses

- `500`: Erro interno do servidor (500).

---

[API](https://skmtc.dev/fipex/apis/api-fipex.md) · [All operations](https://skmtc.dev/fipex/apis/api-fipex/llms.txt) · [OpenAPI document](https://skmtc.dev/fipex/apis/api-fipex/revisions/800eab7da73d?raw)