Queries

Resolve municipality

Name (accent- and case-insensitive, partial) → ibge_code, state (UF), region and population. Use it to disambiguate municipalities with the same name.

Reads

municipios

Page

20 rows × up to 1 page

Params

Documented columns

• ibge_code — IBGE code (7 digits) — join key
• nome — Municipality name
• uf — State (UF) abbreviation
• regiao — Macro-region
• populacao_2022 — Population in the 2022 Census(inhabitants)

Example

What is the IBGE code of Santos, in São Paulo state?

Municipality profile

Snapshot of a municipality: population, area, GDP, MHDI, Gini, health, education (IDEB, enrollments), municipal finances, sanitation and mayor elected in 2024.

Reads

municipios

Page

1 rows × up to 1 page

Params

Documented columns

• populacao_2022 — Population (2022 Census)(inhabitants)
• pib — Municipal GDP (IBGE)(R$ thousand)
• idhm — Municipal HDI (Atlas Brasil, 2010)
• receita_total_2023 — Municipality's total revenue in 2023 (SICONFI)(R$)
• prefeito_eleito_2024 — Mayor elected in 2024 (TSE)

Example

Give me a profile of São Paulo/SP: population, GDP, HDI, health,
education and elected mayor.

Search municipal indicators

Searches the dictionary of municipal-level indicators (~700 from ~20 sources: IBGE/PAM/PPM, SINISA/SNIS, CNES, INEP, RAIS, SINESP, National Treasury, Bolsa Família/BPC, INPE…). Returns indicador_id, unit, frequency and coverage — use the indicador_id in indicador_serie, ranking and comparar.

Reads

indicadores_dicionario

Page

50 rows × up to 3 pages

Params

Documented columns

• indicador_id — Identifier for indicador_serie/ranking/comparar
• periodicidade — annual, monthly…
• n_municipios — Municipalities with data

Example

Which municipal indicators about schools are available?

Indicator time series

Values of an indicator (indicador_id from indicadores_buscar) for 1 to 10 municipalities over time, with unit and source.

Reads

indicadores_serie, municipios

Page

200 rows × up to 5 pages

Params

Documented columns

• periodo — YYYY, YYYY-MM or YYYYQn depending on the frequency
• valor — Indicator value (see unit)

Example

How has the number of Bolsa Família beneficiaries in Santos and São
Paulo changed since January 2025?

Municipality ranking by indicator

Top N (<= 100) municipalities by an indicator in a period (default: the most recent), nationwide, in a state (UF) or region.

Reads

indicadores_serie, municipios

Page

100 rows × up to 1 page

Params

Documented columns

• posicao — Ranking position

Example

Which 10 municipalities in São Paulo state have the most formal jobs?

Compare municipalities across several indicators

Up to 10 municipalities × up to 10 indicators; by default the most recent value of each pair (or of a fixed period).

Reads

indicadores_serie, municipios

Page

100 rows × up to 1 page

Params

Example

Compare Santos and Campinas on formal jobs and number of schools.

Municipality foreign trade

A municipality's exports or imports (Comex Stat), aggregated by year, product (SH4) or destination/origin country, in US$ FOB and kg.

Reads

comex_municipio

Page

100 rows × up to 3 pages

Params

Documented columns

• valor_fob_usd — FOB value(US$)
• kg_liquido — Net weight(kg)

Example

How much did Santos export per year?

Municipality businesses by CNAE and size

Active establishments (Federal Revenue Service, CNPJ) in a municipality aggregated by CNAE (division, group, class or subclass), broken down by size (ME, EPP, others). Never lists individual companies.

Reads

empresas_municipio_cnae

Page

200 rows × up to 3 pages

Params

Documented columns

• qtd_me — Micro-enterprises(establishments)
• qtd_epp — Small businesses(establishments)

Example

Which sectors (CNAE divisions) have the most companies in Santos?

Federal spending located in the municipality

Execution of FEDERAL spending located in the municipality (Transparency Portal) by function — or by subfunction when a function is given — in a year (default: the most recent). This is not the city government's budget.

Reads

orcamento_execucao_municipal

Page

100 rows × up to 2 pages

Params

Documented columns

• pago — Amount paid(R$)

Example

How much federal spending was executed in Santos in 2025, by function?

Parliamentary amendments

Parliamentary amendments (Transparency Portal) by municipality where applied and/or author, aggregated by year, author, municipality and function, with committed and paid amounts.

Reads

emendas_parlamentares

Page

200 rows × up to 3 pages

Params

Documented columns

• pago — Amount paid(R$)

Example

Which parliamentary budget amendments went to Santos since 2023?

Chamber of Deputies bills — summary

How many bills and propositions were introduced in the Chamber of Deputies per year and type (PL, PEC, MPV…), optionally filtered by words in the summary. Aggregated summary, without listing propositions.

Reads

camara_proposicoes

Page

200 rows × up to 2 pages

Params

Example

How many bills did the Chamber of Deputies receive per year since 2023?

Chamber of Deputies votes — summary

Chamber of Deputies votes by year and body (Plenary, committees), with how many were approved. Aggregated summary.

Reads

camara_votacoes

Page

200 rows × up to 2 pages

Params

Example

Summarize the Chamber of Deputies' floor votes since 2024.

Municipality vehicle fleet

Registered fleet (SENATRAN) by vehicle type in the most recent period.

Reads

frota_municipio

Page

40 rows × up to 1 page

Params

Documented columns

• qtd — Registered vehicles(vehicles)

Example

What is Santos's vehicle fleet, by type?

Municipality fuel stations

Retail fuel resellers authorized by ANP in the municipality (most recent registry), optionally by brand.

Reads

anp_postos

Page

100 rows × up to 3 pages

Params

Example

Which fuel stations are there in Santos, and under which brands?

Macroeconomic series

Daily Selic, monthly IPCA or US dollar exchange rate (BACEN/SGS) over a date range; without a range, the 30 most recent observations.

Reads

macro_serie

Page

200 rows × up to 5 pages

Params

Documented columns

• valor — Selic: % per day; IPCA: % in the month; exchange rate: R$/US$

Example

Show me the daily Selic rate series.

Look up CEP

Address and municipality (ibge_code) of ONE CEP (postal code). Does not list CEPs.

Reads

ceps

Page

1 rows × up to 1 page

Params

Example

Where is postal code (CEP) 11010-000?

Constitutional transfers to the municipality

Federal transfers to the municipality (National Treasury): FPM, Fundeb, ITR, CIDE-Combustíveis, IOF-Ouro, LC 176/2020, Lei Kandir and FEX, by year or month, with the period total and each transfer's share. Default: last 5 years. Gap: SUS fund-to-fund transfers (FNS), ICMS/IPVA revenue shares and voluntary transfers are NOT in the lake.

Reads

indicadores_serie, indicadores_dicionario

Page

200 rows × up to 3 pages

Params

Documented columns

• periodo — Year (YYYY) or month (YYYY-MM) of the credit
• transferencia — Transfer id (stn.fpm, stn.fundeb, stn.itr, stn.cide, stn.iof_gold, stn.lc_176, stn.lc_8796, stn.fex)
• valor_brl — Amount transferred in the period (nominal; source: National Treasury)(R$)
• participacao_pct — Transfer's share of the period total(%)
• total_periodo_brl — Sum of all transfers in the period(R$)
• meses_com_repasse — Months in the period with a credit for this transfer(months)

Example

How much does Campinas receive in constitutional transfers (FPM,
Fundeb…)?

Municipality vs. peers of the same size

Compares a municipality with an automatic group of up to 30 peers: same state (UF) (or same region, if the state has fewer than 10) with population between -30% and +30% (if there are not 10, the 30 closest in population in the region). For each indicator (up to 5) it returns the municipality's value, median, p25, p75, the municipality's percentile among its peers and only the top 5/bottom 5 peers — never the full list.

Reads

indicadores_serie, indicadores_dicionario, municipios

Page

5 rows × up to 1 page

Params

Documented columns

• valor_municipio — Municipality's value in the period (see unit)
• n_pares — Peers with data for this indicator/period(municipalities)
• mediana_pares — Peer median (same unit as the indicator)
• p25_pares — Peer 25th percentile
• p75_pares — Peer 75th percentile
• percentil_entre_pares — Municipality's position among peers (0 = lowest value, 100 = highest; ties count as half)(percentile (0-100))
• grupo_escopo — uf = peers in the same state; regiao = peers in the same macro-region
• grupo_criterio — populacao_30pct = population between -30% and +30%; populacao_mais_proxima = the closest in population
• grupo_tamanho — Peer group size (up to 30)(municipalities)
• grupo_pop_min — Smallest population in the group (2025 estimate or 2022 Census)(inhabitants)
• grupo_pop_max — Largest population in the group(inhabitants)
• maiores_5 — The 5 peers with the highest value (ibge_code, municipio, uf, valor)
• menores_5 — The 5 peers with the lowest value (ibge_code, municipio, uf, valor)

Example

How does Campinas compare with municipalities of the same size on jobs,
schools and Bolsa Família?

Filter municipalities by criteria (screener)

Finds municipalities that meet up to 5 criteria {indicador_id, operador, valor} at once (e.g. population >= 100000 and bf.beneficiarios < 5000), optionally in a state (UF) or region, sorted by an indicator. "populacao" = 2025 estimate (2022 Census if missing). Default period: the most recent of each indicator; a municipality without data for an indicator fails that criterion. At most 50 rows and 1 page (total_encontrados says how many match); each row counts double toward the daily row limit.

Reads

indicadores_serie, municipios

Page

50 rows × up to 1 page

Params

Documented columns

• populacao — Population (2025 estimate; 2022 Census if missing)(inhabitants)
• valor_ordenacao — Value of the indicator used for sorting (indicator's unit)
• valores_criterios — Municipality's value for each criterion, in the order given (indicador_id, periodo, valor, unidade)
• total_encontrados — How many municipalities meet all criteria (the list returns at most 50)(municipalities)

Example

List 10 municipalities in São Paulo state with over 100,000 residents
and over 50,000 formal jobs.

Ranking of an indicator's change between two periods

Municipalities with the largest increase or largest decrease in an indicator between periodo_inicio and periodo_fim, with absolute and percentage change; sorts by the chosen measure (percentage ignores zero/negative bases). Top N <= 50, nationwide, in a state (UF) or region; populacao_min excludes very small municipalities.

Reads

indicadores_serie, municipios

Page

50 rows × up to 1 page

Params

Documented columns

• valor_inicio — Value in the base period (see unit)
• valor_fim — Value in the end period (see unit)
• variacao_absoluta — valor_fim - valor_inicio (indicator's unit)
• variacao_pct — Percentage change (null when valor_inicio <= 0)(%)

Example

In which 10 municipalities in São Paulo state did Bolsa Família fall the
most between January 2025 and June 2026?

Municipality agriculture and livestock (crops and herds)

Agricultural production (IBGE PAM: temporary and permanent crops — harvested area, quantity, production value, yield and share of total value) and livestock (IBGE PPM: herd sizes, milked cows and production of milk, eggs, honey, wool) of a municipality in a year (default: the most recent). Gap: the value of animal production (R$) and forestry/plant extraction are not in the lake.

Reads

indicadores_serie, indicadores_dicionario

Page

100 rows × up to 1 page

Params

Documented columns

• tipo — temporary crop, permanent crop (PAM); herd (headcount) or animal-origin production (PPM)
• ano — Reference year
• area_colhida_ha — Harvested area (PAM)(hectares)
• quantidade — Quantity produced (PAM) or headcount/production (PPM) — see unidade_quantidade
• unidade_quantidade — tonnes or thousand fruits (PAM); head, thousand liters, thousand dozen or kilograms (PPM)
• valor_producao_mil_brl — Agricultural production value (PAM; nominal)(R$ thousand)
• participacao_valor_pct — Crop's share of the total value of the municipality's crops(%)
• rendimento_kg_ha — Average yield (PAM; null for products measured in thousand fruits)(kg/ha)

Example

What does Sorriso (Mato Grosso) produce in farming and livestock?

Municipality education (basic and higher)

Education in a municipality: INEP School Census (schools by network and location, enrollments by stage, teachers, student/teacher ratio, % of schools with internet, library, labs etc.), Higher Education Census (HEIs, programs, enrollments, new entrants, graduates) and IDEB 2023 (early/final years). Default year: the most recent of each source; includes the previous year's value for comparison. Gap: the lake only has the 2023 IDEB (no series, no SAEB, no pass/dropout rates).

Reads

indicadores_serie, indicadores_dicionario, municipios

Page

60 rows × up to 1 page

Params

Documented columns

• grupo — basic education (INEP), higher education (INEP/MEC) or IDEB
• periodo — Census reference year
• valor — Value (see unit: schools, enrollments, teachers, percentage, index…)
• valor_anterior — Value in the previous available year
• variacao_pct — Change from the previous year(%)

Example

What does education look like in Campinas, from basic to higher
education?

Municipality health (facilities and health plans)

A municipality's health network: CNES facilities (total and by type — UBS, hospitals, emergency care, CAPS, clinics…) per 10,000 inhabitants, and health plan beneficiaries (ANS) with coverage relative to the population. Default period: the most recent of each source (uses the last <= periodo). Gap: beds (CNES-LT), professionals, SUS production and the public/private split of facilities are NOT in the lake.

Reads

indicadores_serie, indicadores_dicionario, municipios

Page

60 rows × up to 1 page

Params

Documented columns

• periodo — Reference month (YYYY-MM)
• valor — Facilities (CNES) or beneficiaries (ANS)
• por_10mil_hab — Facilities per 10,000 inhabitants(facilities/10,000 inhab.)
• cobertura_pct — Health plan beneficiaries / population(%)
• populacao_referencia — Population used in the relative indicators (2025 estimate; 2022 Census if missing)(inhabitants)

Example

What does health care look like in Campinas: facilities and health
plans?

Social programs in the municipality (Bolsa Família, BPC, Pé-de-Meia)

Bolsa Família, BPC/LOAS and Pé-de-Meia in a municipality: beneficiaries (last month and monthly average), total amount paid, monthly average, per capita amount and beneficiaries per 1,000 inhabitants, plus a total row. Default: the last 12 available months of each program. Pé-de-Meia counts payments (a student may receive more than one in a month).

Reads

indicadores_serie, municipios

Page

10 rows × up to 1 page

Params

Documented columns

• unidade_beneficiarios — Bolsa Família counts families; BPC, people; Pé-de-Meia, payments
• meses — Months with data in the window(months)
• beneficiarios_ultimo_mes — Beneficiaries in the last month of the window (see unidade_beneficiarios)
• beneficiarios_media_mensal — Monthly average of beneficiaries in the window
• valor_total_brl — Total amount paid in the window (nominal)(R$)
• valor_medio_mensal_brl — Average amount paid per month(R$)
• valor_per_capita_brl — Total amount paid in the window / municipality population(R$ per inhabitant)
• beneficiarios_por_mil_hab — Last-month beneficiaries per 1,000 inhabitants(per 1,000 inhabitants)
• populacao_referencia — Population used for per capita (2025 estimate; 2022 Census if missing)(inhabitants)

Example

How many people in Campinas receive Bolsa Família, BPC and Pé-de-Meia?