População, PIB e geografia pelo IBGE
Quase toda conclusão sobre dado fiscal precisa de um denominador: sem população, "a cidade que mais gastou" é só "a maior cidade". O IBGE publica população, PIB e geografia por API aberta, sem cadastro — e usa o mesmo código de ente que o Tesouro, o que faz as duas fontes conversarem sem tabela de tradução.
As três APIs que importam
- Agregados (SIDRA). As tabelas estatísticas por API. É de onde vêm população e PIB. Uma chamada devolve os 5.571 municípios de uma vez.
- Localidades. Nome, código e hierarquia de municípios, estados, regiões e mesorregiões. Serve para traduzir nome em código, que é sempre o caminho mais seguro.
- Malhas. A geometria para desenhar mapa. Peça por UF: a do país inteiro passa de 3 MB.
População: a chamada
Agregado 6579, variável 9324 — estimativa da população residente, todos os municípios:
https://servicodados.ibge.gov.br/api/v3/agregados/6579/periodos/-1/variaveis/9324?localidades=N6%5Ball%5D
- Os colchetes precisam ir codificados.
localidades=N6[all]viralocalidades=N6%5Ball%5D, ou o terminal os interpreta como expansão de nome de arquivo. - O período
-1pede o mais recente, e o ano vem no retorno. Nunca presuma qual é: leia a chave dentro deserie. Este site publica a estimativa de 2026, e a trava reprova o build se ela ficar mais de dois anos atrás. - É estimativa, não contagem. Projeção oficial para 1º de julho do ano indicado. Em município que cresceu ou encolheu rápido, a diferença para o censo importa — e é uma ressalva a declarar junto com qualquer número per capita.
- A resposta vem comprimida mesmo sem pedir. Um cliente que não descomprime sozinho recebe bytes ilegíveis e conclui que a API quebrou.
PIB municipal
Agregado 5938, variável 37 — Produto Interno Bruto a preços correntes, em mil reais. Trocando o código do município no fim:
https://servicodados.ibge.gov.br/api/v3/agregados/5938/periodos/-1/variaveis/37?localidades=N6%5B5300108%5D
Juntar com o dado fiscal
- Use o código, não o nome. O código do IBGE tem sete dígitos e o sétimo é verificador, então erro de digitação quase sempre é detectável. Nome tem acento, abreviação e homônimo — há quinze "Bom Jesus" no país.
- O SICONFI usa o mesmo código. No campo
cod_ibgeda tabela de entes. É o que dispensa qualquer tabela de tradução entre dado fiscal e demográfico. - Junte e olhe o que não casou. Em juntar duas tabelas, a taxa de casamento aparece primeiro. Se ficou abaixo de 100%, veja quem faltou antes de concluir qualquer coisa.
- Divida. Em valor por habitante, que já traz a população versionada e avisa quando o ano do seu dado não bate com o dela.
- Desenhe, com o cuidado da comparação. Municípios de porte muito diferente não se comparam bem nem per capita — o denominador corrige o tamanho, não o custo de vida.
Duas armadilhas de contagem
- O país tem mais municípios que a malha mostra. Na verificação de 22 de setembro de 2026, a lista de população trazia 5.571 municípios e a malha geográfica, 5.570: um município novo já existe como ente e ainda não tem geometria publicada. Quem desenha mapa perde essas linhas, e o certo é declarar a lacuna em vez de deixá-las sumirem.
- O Distrito Federal é um caso à parte. Brasília aparece como município de código 5300108, e o DF como ente de código 53. Somar os dois conta a mesma população duas vezes.