ibge_sidra
Query IBGE SIDRA tables for population estimates, census data, unemployment, income, GDP, and more. Retrieve raw statistical data from Brazil's official surveys at various territorial levels.
Instructions
Queries SIDRA tables (IBGE's Automatic Recovery System).
SIDRA contains data from IBGE surveys like Census, PNAD, GDP, etc.
Common tables:
6579: Population estimates (annual)
9514: Census 2022 population
200: Census population (1970-2010)
4714: Unemployment rate (PNAD Contínua)
6381: Average income (PNAD Contínua)
6706: GDP at current prices
5938: GDP per capita
Territorial levels:
1: Brazil
2: Region (North, Northeast, etc.)
3: State (UF)
6: Municipality
7: Metropolitan Region
Examples:
Brazil population 2023: tabela="6579", periodos="2023"
Population by state: tabela="6579", nivel_territorial="3"
Census 2022 by municipality: tabela="9514", nivel_territorial="6", localidades="3550308"
ibge_sidra is the low-level engine. Prefer a friendlier wrapper when it fits:
Census themes (1970–2022) → ibge_censo
Economic/social time series → ibge_indicadores
Rank/compare 2–10 localities → ibge_comparar
One municipality's panel → ibge_cidades Use ibge_sidra_tabelas and ibge_sidra_metadados to find a table code and its structure before querying.
Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tabela | Yes | Código da tabela SIDRA (ex: 6579 para estimativas de população, 9514 para censo 2022) | |
| variaveis | No | IDs das variáveis separados por vírgula, ou 'allxp' para todas | allxp |
| nivel_territorial | No | Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Município, 7=Região Metropolitana, 8=Mesorregião, 9=Microrregião, 10=Distrito, 11=Subdistrito, 13=RM/RIDE, 14=RIDE, 15=Aglomeração Urbana, 17=Região Geográfica Imediata, 18=Região Geográfica Intermediária, 105=Macrorregião de Saúde, 106=Região de Saúde, 114=Aglomerado Subnormal, 127=Amazônia Legal, 128=Semiárido | 1 |
| localidades | No | Códigos das localidades separados por vírgula, ou 'all' para todas | all |
| periodos | No | Períodos: 'last' para último, 'all' para todos, ou anos específicos (ex: 2020,2021,2022) | last |
| classificacoes | No | Classificações no formato 'id[categorias]' (ex: '2[6794]' para sexo masculino) | |
| formato | No | Formato de saída: 'json' para dados brutos ou 'tabela' para formato legível | tabela |
| pagina | No | Página de resultados (100 registros por página) | |
| campos | No | Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta. Omitir traz todas. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tabela | Yes | Código da tabela SIDRA consultada | |
| nome | Yes | Nome da tabela (quando conhecido) | |
| totalRegistros | Yes | Total de registros de dados disponíveis (todas as páginas) | |
| colunas | Yes | Rótulos das colunas, na ordem | |
| registros | Yes | Registros da página atual: cada um mapeia rótulo da coluna -> valor | |
| paginacao | Yes | Metadados de paginação para continuação |