Censo Demográfico — Dados Populacionais por Município

https://servicodados.ibge.gov.br/api/v3/agregados/{pesquisa}/periodos/{periodo}/variaveis/{variavel}?localidades=N6[all]

import requests
import pandas as pd
 
# População residente por município (Censo 2022)
# Tabela 4714 — População residente
url = (
    "https://servicodados.ibge.gov.br/api/v3/agregados/4714"
    "/periodos/2022/variaveis/93"
    "?localidades=N6[all]"
)
 
response = requests.get(url)
response.raise_for_status()
dados = response.json()
 
# Extrair dados
registros = []
for resultado in dados[0]["resultados"]:
    for local_id, valor in resultado["series"][0]["serie"].items():
        pass  # Estrutura aninhada — veja abaixo
 
# Alternativa mais prática: usar a API SIDRA
url_sidra = (
    "https://apisidra.ibge.gov.br/values/t/4714/n6/all/v/93/p/2022"
)
 
response = requests.get(url_sidra)
response.raise_for_status()
dados = response.json()
 
# Converter para DataFrame
df = pd.DataFrame(dados[1:], columns=[d for d in dados[0].values()])
print(f"Total de municípios: {len(df):,}")
print(df[["Município", "Valor"]].head(10))

import sidrapy
 
# População por sexo e idade — todos os municípios
dados = sidrapy.get_table(
    table_code="4714",
    territorial_level="6",  # Município
    ibge_territorial_code="all",
    variable="93",  # População residente
    period="2022",
)
 
print(f"Total de registros: {len(dados):,}")
print(dados[["D1N", "V"]].head(10))  # D1N=Nome do município, V=Valor

import sidrapy
import pandas as pd
 
dados = sidrapy.get_table(
    table_code="4714",
    territorial_level="6",
    ibge_territorial_code="all",
    variable="93",
    period="2022",
)
 
# Limpar e ordenar
dados["V"] = pd.to_numeric(dados["V"], errors="coerce")
top10 = dados.nlargest(10, "V")[["D1N", "V"]]
top10.columns = ["Município", "População"]
 
print("Top 10 municípios mais populosos (Censo 2022):")
print(top10.to_string(index=False))