Documentação
Dados abertos
O ranking do Onde Viver Bem, com 175 cidades, está disponível em arquivos estáticos e versionados, atualizados em 18 de novembro de 2026. Cada métrica leva valor, unidade, fonte, marca de estimado e o método. As notas são editoriais e indicativas: não são recomendação de imigração, investimento ou compra de imóvel.
Data da base: 18 de novembro de 2026. GET e HEAD são abertos, com CORS liberado para qualquer origem. Não há chave nem limite além do da CDN.
Endereços
| Recurso | O que traz | Formato |
|---|---|---|
/api/v1/cidades.json | As 175 cidades, com todas as métricas publicadas | JSON |
/api/v1/cidades.csv | A mesma lista em tabela compacta (nota, m², URLs) | CSV |
/api/v1/cidades/{slug}.json | Uma cidade, por exemplo es-malaga ou pt-porto | JSON |
/api/v1/paises.json | Países, com a posição de cada cidade no país e no ranking global | JSON |
/api/v1/bairros.json | Regiões dos mapas de bairros e a nota combinada quando entram no ranking público | JSON |
/api/v1/openapi.json | Contrato em OpenAPI 3.1 | JSON |
/llms.txt | Mapa curto do site, no padrão llms.txt v2 | Markdown |
/llms-full.txt | O mesmo, com a lista de cidades e notas | Markdown |
Para agentes de IA
Comece pelo /llms.txt (índice curto) ou pelo /llms-full.txt (cidades e notas). O manifesto OpenAPI 3.1 em /api/v1/openapi.json pode ser importado como esquema de ações, sem autenticação. Há um manifesto de descoberta em /.well-known/ai-plugin.json. Um endpoint MCP só de leitura, no worker já existente e sem custo novo, está em /mcp (manifesto: /.well-known/mcp.json). O robots.txt libera os rastreadores GPTBot, ClaudeBot, PerplexityBot e Google-Extended.
Licença e atribuição
Os arquivos em /api/v1 podem ser lidos e reutilizados com atribuição ao Onde Viver Bem (https://ondeviverbem.com) e à fonte citada em cada métrica. As notas são uma compilação editorial. Os dados brutos permanecem nos termos de cada fonte (indicados no objeto fonte, inclusive a licença da fonte quando a conhecemos). Não apresente uma estimativa como medição, e não cite uma versão interna do estudo — use a data.
Contato: contato@ondeviverbem.com · Metodologia · Quem faz