IBGE

App · 20 actions

Look up Brazil's official statistics from IBGE, the national statistics institute. Find states and municipalities with their IBGE codes and regions; see how common a first name is by decade and state; follow IBGE's news, new figures and release calendar; search and fetch any SIDRA statistics table, such as population estimates or IPCA inflation; compare countries on IBGE's indicators; and look up CNAE business activity codes. Everything reads: nothing here changes anything. No account or API key required.

Actions

ActionWhat it does
Compare a name across statesSee how common a first name is in each of the 27 states, as people per 100,000, most common first, from the 2010 census.
Get a CNAE activityLook up a CNAE code, the classification of economic activities every Brazilian company registers under, and get its name, the class, group, division and section above it, the activities filed under it and IBGE's notes on what it covers and excludes.
Get a country profileGet IBGE's profile of any country: its codes, its name in Portuguese, English and Spanish, capital, area, region, languages, currencies and a short history in Portuguese.
Get a municipalityLook up one municipality by its code or its name and get its 7-digit IBGE code, its state and region, and the intermediate, immediate, meso and micro regions it sits in.
Get a name's frequency by decadeFind out how many people in Brazil, a state or a municipality have a first name, decade by decade of birth, from the 2010 census, and which decade it peaked in.
Get a table's detailsRead what a SIDRA table holds: its survey, how often it is updated and over which periods, the variables it measures with their units, the kinds of place it covers, and the classifications that break its figures down.
Get country indicatorsCompare countries on IBGE's indicators, such as GDP per capita, population, life expectancy, internet use or exports: the latest figure and its whole series for each country and indicator.
Get values from a tableFetch figures from a SIDRA table: the latest population of every municipality in a state, the last twelve months of inflation, a harvest by crop.
List a municipality's districtsList the districts a municipality is divided into, with IBGE's 9-digit code for each.
List a table's periodsList every period a SIDRA table has figures for, oldest first, with when each was last revised.
List immediate regionsList a state's immediate geographic regions, the groups of municipalities around a nearby city that replaced the old microregions, each with the intermediate region it belongs to.
List intermediate regionsList a state's intermediate geographic regions, the divisions IBGE drew in 2017 around a state's main cities to replace the old mesoregions.
List metropolitan regionsList a state's metropolitan regions as its state law defines them, each with every municipality in it.
List municipalitiesList municipalities in one state or in all of Brazil (5,571 of them), optionally only those whose name contains some text, with each one's 7-digit IBGE code and the regions it belongs to.
List statesList Brazil's 26 states and the Federal District, or those of one region, with the two-letter code, IBGE's number for each and the region it belongs to.
List the release calendarList what IBGE has scheduled to publish, soonest first: inflation, jobs, GDP and every other survey, from today or between two dates, for one survey or all of them.
Rank the most common namesGet the 20 most common first names from the 2010 census, for all of Brazil, a state or a municipality, for people born in one decade, and for women or men.
Search CNAE activitiesFind the CNAE code for a kind of business from words that describe it, in Portuguese: 'padaria' finds bakeries that make their own bread and those that resell it.
Search news and releasesSearch the IBGE news agency's stories and its releases of new figures (inflation, unemployment, GDP, harvests), newest first, by words, kind, survey and date.
Search statistics tablesFind SIDRA tables, IBGE's published statistics, by words in the table's or its survey's name, optionally only those published for municipalities or states, or monthly.

Compare a name across states

See how common a first name is in each of the 27 states, as people per 100,000, most common first, from the 2010 census. Use it to find where a name is a regional favourite.

Inputs

First namenametextRequired
One first name, such as Maria. Accents and capitals do not matter. IBGE counts single names only, so a compound name such as Maria Clara is refused.
Sexsextext
Only women or only men. Leave it empty for everyone.One of: F (Women), M (Men).

Outputs

countnumber
How many states are in the result
foundtrue/false
False when the census records nobody with the name
highest_statetext
The state where the name is most common
lowest_statetext
The state where it is least common
nametext
The name, in capitals
searched_fortext
The name that was looked up
sextext
F or M when narrowed to women or men, else empty
stateslist
One row per state, most common first
Example output
{
  "count": 3,
  "found": true,
  "highest_state": "Cear\u00e1",
  "lowest_state": "Rio Grande do Sul",
  "name": "ANA",
  "searched_for": "Ana",
  "sex": "",
  "states": [
    {
      "count": 182135,
      "per_100k": 2154.84,
      "population": 8452381,
      "state_code": "CE",
      "state_id": 23,
      "state_name": "Cear\u00e1"
    },
    {
      "count": 49963,
      "per_100k": 1943.96,
      "population": 2570160,
      "state_code": "DF",
      "state_id": 53,
      "state_name": "Distrito Federal"
    },
    {
      "count": 60148,
      "per_100k": 1898.59,
      "population": 3168027,
      "state_code": "RN",
      "state_id": 24,
      "state_name": "Rio Grande do Norte"
    }
  ]
}

Get a CNAE activity

Look up a CNAE code, the classification of economic activities every Brazilian company registers under, and get its name, the class, group, division and section above it, the activities filed under it and IBGE's notes on what it covers and excludes. Takes a subclass such as 6201-5/01 or a class such as 62.01-5.

Inputs

CNAE codecodetextRequired
The code, with or without its dots, dash and slash: 6201-5/01 and 6201501 are the same subclass.

Outputs

activitieslist
The activities filed under a subclass
class_codetext
The class code
class_nametext
The class name
codetext
The code as digits
descriptiontext
Its name, in Portuguese
division_codetext
The division code
division_nametext
The division name
formatted_codetext
The code as it is usually written
group_codetext
The group code
group_nametext
The group name
kindtext
subclass for a 7-digit code, class for a 5-digit one
noteslist
IBGE's notes on what it covers and excludes
section_codetext
The section letter, A to U
section_nametext
The section name
Example output
{
  "activities": [
    "BANCO DE DADOS SOB ENCOMENDA; DESENVOLVIMENTO DE",
    "CRIA\u00c7\u00c3O, CONFIGURA\u00c7\u00c3O DE SOFTWARE DE BANCO DE DADOS SOB ENCOMENDA",
    "DESENVOLVIMENTO DE APLICATIVO INFORM\u00c1TICO SOB ENCOMENDA"
  ],
  "class_code": "62015",
  "class_name": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
  "code": "6201501",
  "description": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
  "division_code": "62",
  "division_name": "ATIVIDADES DOS SERVI\u00c7OS DE TECNOLOGIA DA INFORMA\u00c7\u00c3O",
  "formatted_code": "6201-5/01",
  "group_code": "620",
  "group_name": "ATIVIDADES DOS SERVI\u00c7OS DE TECNOLOGIA DA INFORMA\u00c7\u00c3O",
  "kind": "subclass",
  "notes": [
    "Esta subclasse compreende o desenvolvimento de sistemas para atender \u00e0s necessidades do cliente e a programa\u00e7\u00e3o com o uso de ferramentas e de linguagens de programa\u00e7\u00e3o"
  ],
  "section_code": "J",
  "section_name": "INFORMA\u00c7\u00c3O E COMUNICA\u00c7\u00c3O"
}

Get a country profile

Get IBGE's profile of any country: its codes, its name in Portuguese, English and Spanish, capital, area, region, languages, currencies and a short history in Portuguese.

Inputs

CountrycountrytextRequired
The country. Pick it from the list, or give its two- or three-letter code such as AR or ARG.

Outputs

area_km2number
The area in square kilometres
capitaltext
The capital
codetext
The ISO two-letter code, such as BR
currencieslist
Its currencies
historytext
IBGE's short history of the country, in Portuguese
intermediate_regiontext
The UN intermediate region, empty when none
iso3text
The ISO three-letter code, such as BRA
languageslist
Its languages, in Portuguese
m49number
The UN M49 number
nametext
The name in Portuguese
name_entext
The name in English
name_estext
The name in Spanish
regiontext
The continent, in Portuguese
subregiontext
The UN subregion, in Portuguese
Example output
{
  "area_km2": 8509360.85,
  "capital": "Bras\u00edlia",
  "code": "BR",
  "currencies": [
    {
      "code": "BRL",
      "name": "Real brasileiro"
    }
  ],
  "history": "Maior pa\u00eds da Am\u00e9rica do Sul, com vasta \u00e1rea de litoral banhada pelo oceano Atl\u00e2ntico. Tem fronteiras com Venezuela, Guiana, Suriname, Guiana Francesa, Col\u00f4mbia, Peru, Bol\u00edvia, Paraguai, Argentina e U",
  "intermediate_region": "Am\u00e9rica do sul",
  "iso3": "BRA",
  "languages": [
    "portugu\u00eas"
  ],
  "m49": 76,
  "name": "Brasil",
  "name_en": "Brazil",
  "name_es": "Brasil",
  "region": "Am\u00e9rica",
  "subregion": "Am\u00e9rica Latina e Caribe"
}

Get a municipality

Look up one municipality by its code or its name and get its 7-digit IBGE code, its state and region, and the intermediate, immediate, meso and micro regions it sits in. A name several states share is refused with the states it was found in, rather than guessed.

Inputs

Statestatetext
The state the municipality is in. It fills the municipality list, and tells two places with the same name apart. Leave it empty when you give the municipality's code.One of: AC (Acre (AC)), AL (Alagoas (AL)), AP (Amapá (AP)), AM (Amazonas (AM)), BA (Bahia (BA)), CE (Ceará (CE)), DF (Distrito Federal (DF)), ES (Espírito Santo (ES)), GO (Goiás (GO)), MA (Maranhão (MA)), and 17 more.
MunicipalitymunicipalitytextRequired
The municipality. Choose the state to pick it from the list, or give IBGE's 7-digit code (3304557 is Rio de Janeiro), the 6-digit code some other systems use, or its name. Accents and capitals do not matter.

Outputs

idnumber
IBGE's 7-digit code for the municipality, such as 3304557
immediate_region_idnumber
IBGE's code for its immediate geographic region
immediate_region_nametext
The immediate geographic region's name
intermediate_region_idnumber
IBGE's code for its intermediate geographic region
intermediate_region_nametext
The intermediate geographic region's name
mesoregion_idnumber
IBGE's code for its mesoregion (the older division), empty for a municipality created after mesoregions were drawn
mesoregion_nametext
The mesoregion's name, empty when it has none
microregion_idnumber
IBGE's code for its microregion (the older division), empty for a municipality created after microregions were drawn
microregion_nametext
The microregion's name, empty when it has none
nametext
The municipality's name
region_codetext
Its region's abbreviation: N, NE, SE, S or CO
region_nametext
Its region's name in Portuguese
searched_fortext
What was looked up
state_codetext
Its state's two-letter abbreviation
state_idnumber
IBGE's two-digit code for its state
state_nametext
Its state's name
Example output
{
  "id": 3303302,
  "immediate_region_id": 330001,
  "immediate_region_name": "Rio de Janeiro",
  "intermediate_region_id": 3301,
  "intermediate_region_name": "Rio de Janeiro",
  "mesoregion_id": 3306,
  "mesoregion_name": "Metropolitana do Rio de Janeiro",
  "microregion_id": 33018,
  "microregion_name": "Rio de Janeiro",
  "name": "Niter\u00f3i",
  "region_code": "SE",
  "region_name": "Sudeste",
  "searched_for": "3303302",
  "state_code": "RJ",
  "state_id": 33,
  "state_name": "Rio de Janeiro"
}

Get a name's frequency by decade

Find out how many people in Brazil, a state or a municipality have a first name, decade by decade of birth, from the 2010 census, and which decade it peaked in. Use it to estimate someone's age from their name or to see a name rise and fall.

Inputs

First namenametextRequired
One first name, such as Maria. Accents and capitals do not matter. IBGE counts single names only, so a compound name such as Maria Clara is refused.
Statestatetext
Only people in this state. Leave it empty for all of Brazil.One of: AC (Acre (AC)), AL (Alagoas (AL)), AP (Amapá (AP)), AM (Amazonas (AM)), BA (Bahia (BA)), CE (Ceará (CE)), DF (Distrito Federal (DF)), ES (Espírito Santo (ES)), GO (Goiás (GO)), MA (Maranhão (MA)), and 17 more.
Municipalitymunicipalitytext
Only people in this municipality. Choose the state to pick it from the list, or give its 7-digit code. Leave it empty for the whole state or country.
Sexsextext
Only women or only men. Leave it empty for everyone.One of: F (Women), M (Men).

Outputs

decadeslist
One row per decade of birth, oldest first
foundtrue/false
False when the census records nobody with the name
location_idtext
BR, or IBGE's code for the state or municipality
location_nametext
Where the people were counted
nametext
The name as IBGE records it, in capitals without accents
peak_countnumber
How many were born in that decade
peak_decadetext
The decade with the most births, such as 1950s
searched_fortext
The name that was looked up
sextext
F or M when narrowed to women or men, else empty
totalnumber
How many people have the name, across every decade
Example output
{
  "decades": [
    {
      "count": 32373,
      "decade": "before_1930",
      "from_year": null,
      "label": "Before 1930",
      "to_year": 1929
    },
    {
      "count": 69578,
      "decade": "1930s",
      "from_year": 1930,
      "label": "1930s",
      "to_year": 1939
    },
    {
      "count": 126572,
      "decade": "1940s",
      "from_year": 1940,
      "label": "1940s",
      "to_year": 1949
    },
    {
      "count": 188459,
      "decade": "1950s",
      "from_year": 1950,
      "label": "1950s",
      "to_year": 1959
    },
    {
      "count": 143828,
      "decade": "1960s",
      "from_year": 1960,
      "label": "1960s",
      "to_year": 1969
    },
    {
      "count": 65015,
      "decade": "1970s",
      "from_year": 1970,
      "label": "1970s",
      "to_year": 1979
    },
    {
      "count": 27944,
      "decade": "1980s",
      "from_year": 1980,
      "label": "1980s",
      "to_year": 1989
    },
    {
      "count": 17632,
      "decade": "1990s",
      "from_year": 1990,
      "label": "1990s",
      "to_year": 1999
    },
    {
      "count": 78126,
      "decade": "2000s",
      "from_year": 2000,
      "label": "2000s",
      "to_year": 2009
    }
  ],
  "found": true,
  "location_id": "33",
  "location_name": "Rio de Janeiro",
  "name": "MARIA",
  "peak_count": 188459,
  "peak_decade": "1950s",
  "searched_for": "Maria",
  "sex": "F",
  "total": 749527
}

Get a table's details

Read what a SIDRA table holds: its survey, how often it is updated and over which periods, the variables it measures with their units, the kinds of place it covers, and the classifications that break its figures down.

Inputs

TabletabletextRequired
The SIDRA table's number, such as 6579 for the population estimates or 1737 for the IPCA inflation series. It is in the table's address on sidra.ibge.gov.br, and 'Search statistics tables' finds one.

Outputs

classificationslist
How its figures are broken down, if at all
first_periodtext
The first period it has figures for
frequencytext
How often it is updated, in Portuguese, such as mensal
idnumber
The table's number
last_periodtext
The latest period it has figures for
levelslist
The kinds of place it has figures for
nametext
The table's title, in Portuguese
subjecttext
Its subject, in Portuguese
surveytext
The survey it belongs to
urltext
The table on SIDRA
variableslist
What it measures
Example output
{
  "classifications": [],
  "first_period": "2001",
  "frequency": "anual",
  "id": 6579,
  "last_period": "2026",
  "levels": [
    {
      "id": "N1",
      "name": "Brasil"
    },
    {
      "id": "N2",
      "name": "Grande Regi\u00e3o"
    },
    {
      "id": "N6",
      "name": "Munic\u00edpio"
    },
    {
      "id": "N3",
      "name": "Unidade da Federa\u00e7\u00e3o"
    }
  ],
  "name": "Popula\u00e7\u00e3o residente estimada",
  "subject": "Geral",
  "survey": "Estimativas de Popula\u00e7\u00e3o",
  "url": "https://sidra.ibge.gov.br/tabela/6579",
  "variables": [
    {
      "id": 9324,
      "name": "Popula\u00e7\u00e3o residente estimada",
      "unit": "Pessoas"
    }
  ]
}

Get country indicators

Compare countries on IBGE's indicators, such as GDP per capita, population, life expectancy, internet use or exports: the latest figure and its whole series for each country and indicator. IBGE has no figures for a few countries, such as Argentina, and the result names them.

Inputs

CountriescountrieslistRequired
The countries to compare. Pick as many as you like.
Indicatorsindicatorslist
Which indicators. Leave it empty for all 34.

Outputs

countnumber
How many rows there are
countrieslist
The two-letter codes of the countries read
countries_without_figureslist
Countries IBGE has no figures for, such as Argentina, whose rows come back empty
indicatorslist
One row per country and indicator
Example output
{
  "count": 1,
  "countries": [
    "BR"
  ],
  "countries_without_figures": [],
  "indicators": [
    {
      "country": "Brasil",
      "country_code": "BR",
      "indicator": "Economia - PIB per capita",
      "indicator_id": 77823,
      "latest_period": "2023",
      "latest_value": 10294.87,
      "multiplier": 1,
      "series": [
        {
          "period": "2021",
          "value": 7972.54
        },
        {
          "period": "2022",
          "value": 9281.33
        },
        {
          "period": "2023",
          "value": 10294.87
        }
      ],
      "unit": "US$"
    }
  ]
}

Get values from a table

Fetch figures from a SIDRA table: the latest population of every municipality in a state, the last twelve months of inflation, a harvest by crop. Choose the variables, the kind of place and which places, the periods (or just the latest), and the categories. Every figure comes back as its own row with a number ready to compare. A step returns at most 10,000 figures.

Inputs

TabletabletextRequired
The SIDRA table's number, such as 6579 for the population estimates or 1737 for the IPCA inflation series. It is in the table's address on sidra.ibge.gov.br, and 'Search statistics tables' finds one.
Variablesvariableslist
What to fetch. Leave it empty for every variable in the table.
Kind of placeleveltext
Brazil, regions, states, municipalities, and so on: the list holds the ones this table covers. Leave it empty for Brazil as a whole.
Placeslocationslist
Which places of that kind. Leave it empty for all of them, or for all of them in the state chosen below.
Only in statestatetext
Only places in this state, such as every municipality in RJ. Leave it empty for all of Brazil.One of: AC (Acre (AC)), AL (Alagoas (AL)), AP (Amapá (AP)), AM (Amazonas (AM)), BA (Bahia (BA)), CE (Ceará (CE)), DF (Distrito Federal (DF)), ES (Espírito Santo (ES)), GO (Goiás (GO)), MA (Maranhão (MA)), and 17 more.
Periodsperiodslist
Which periods. Leave it empty to get the latest ones instead, as many as the next field says.
Latest periodslatestnumber
When no periods are chosen, how many of the most recent to fetch. Defaults to 1, the latest.From 1 to 120. Default: 1.
Break down byclassificationtext
A classification to break the figures down by, such as product group for the IPCA. Leave it empty for the table's totals.
Categoriescategorieslist
Which categories of that classification. Leave it empty for every one.

Outputs

classificationtext
The classification broken down by, else empty
countnumber
How many figures were returned
leveltext
The kind of place, such as N3 for states
periodslist
The periods the figures are for
table_idnumber
The table's number
table_nametext
The table's title
valueslist
One row per figure
Example output
{
  "classification": "",
  "count": 2,
  "level": "N3",
  "periods": [
    "2026"
  ],
  "table_id": 6579,
  "table_name": "Popula\u00e7\u00e3o residente estimada",
  "values": [
    {
      "category": "",
      "category_id": "",
      "level": "N3",
      "location": "Rio de Janeiro",
      "location_id": "33",
      "period": "2026",
      "period_label": "2026",
      "unit": "Pessoas",
      "value": 17225410,
      "value_text": "17225410",
      "variable": "Popula\u00e7\u00e3o residente estimada",
      "variable_id": 9324
    },
    {
      "category": "",
      "category_id": "",
      "level": "N3",
      "location": "S\u00e3o Paulo",
      "location_id": "35",
      "period": "2026",
      "period_label": "2026",
      "unit": "Pessoas",
      "value": 46179008,
      "value_text": "46179008",
      "variable": "Popula\u00e7\u00e3o residente estimada",
      "variable_id": 9324
    }
  ]
}

List a municipality's districts

List the districts a municipality is divided into, with IBGE's 9-digit code for each. São Paulo has 96; most small municipalities have one, named after the town.

Inputs

Statestatetext
The state the municipality is in. It fills the municipality list, and tells two places with the same name apart. Leave it empty when you give the municipality's code.One of: AC (Acre (AC)), AL (Alagoas (AL)), AP (Amapá (AP)), AM (Amazonas (AM)), BA (Bahia (BA)), CE (Ceará (CE)), DF (Distrito Federal (DF)), ES (Espírito Santo (ES)), GO (Goiás (GO)), MA (Maranhão (MA)), and 17 more.
MunicipalitymunicipalitytextRequired
The municipality. Choose the state to pick it from the list, or give IBGE's 7-digit code (3304557 is Rio de Janeiro), the 6-digit code some other systems use, or its name. Accents and capitals do not matter.

Outputs

countnumber
How many districts there are
districtslist
The districts, by name
municipality_idnumber
The municipality's 7-digit code
municipality_nametext
The municipality's name
state_codetext
The municipality's state
Example output
{
  "count": 1,
  "districts": [
    {
      "id": 330455705,
      "name": "Rio de Janeiro"
    }
  ],
  "municipality_id": 3304557,
  "municipality_name": "Rio de Janeiro",
  "state_code": "RJ"
}

List a table's periods

List every period a SIDRA table has figures for, oldest first, with when each was last revised. Gaps are real: the population estimates skip census years.

Inputs

TabletabletextRequired
The SIDRA table's number, such as 6579 for the population estimates or 1737 for the IPCA inflation series. It is in the table's address on sidra.ibge.gov.br, and 'Search statistics tables' finds one.

Outputs

countnumber
How many periods there are
first_periodtext
The first period
last_periodtext
The latest period
periodslist
The periods, oldest first
table_idnumber
The table's number
table_nametext
The table's title
Example output
{
  "count": 3,
  "first_period": "2001",
  "last_period": "2003",
  "periods": [
    {
      "id": "2001",
      "label": "2001",
      "updated": "30/08/2017"
    },
    {
      "id": "2002",
      "label": "2002",
      "updated": "30/08/2017"
    },
    {
      "id": "2003",
      "label": "2003",
      "updated": "30/08/2017"
    }
  ],
  "table_id": 6579,
  "table_name": "Popula\u00e7\u00e3o residente estimada"
}

List immediate regions

List a state's immediate geographic regions, the groups of municipalities around a nearby city that replaced the old microregions, each with the intermediate region it belongs to. Narrow it to one intermediate region if you like.

Inputs

StatestatetextRequired
The Brazilian state. Pick it from the list, or use its two-letter code such as RJ.One of: AC (Acre (AC)), AL (Alagoas (AL)), AP (Amapá (AP)), AM (Amazonas (AM)), BA (Bahia (BA)), CE (Ceará (CE)), DF (Distrito Federal (DF)), ES (Espírito Santo (ES)), GO (Goiás (GO)), MA (Maranhão (MA)), and 17 more.
Intermediate regionintermediate_regiontext
Only the immediate regions inside this intermediate region. Leave it empty for the whole state.

Outputs

countnumber
How many there are
intermediate_region_nametext
The intermediate region asked for, empty for the whole state
regionslist
The immediate regions, by code
state_codetext
The state's two-letter code
state_nametext
The state's name
Example output
{
  "count": 3,
  "intermediate_region_name": "Rio de Janeiro",
  "regions": [
    {
      "id": 330001,
      "intermediate_region_id": 3301,
      "intermediate_region_name": "Rio de Janeiro",
      "name": "Rio de Janeiro"
    },
    {
      "id": 330002,
      "intermediate_region_id": 3301,
      "intermediate_region_name": "Rio de Janeiro",
      "name": "Angra dos Reis"
    },
    {
      "id": 330003,
      "intermediate_region_id": 3301,
      "intermediate_region_name": "Rio de Janeiro",
      "name": "Rio Bonito"
    }
  ],
  "state_code": "RJ",
  "state_name": "Rio de Janeiro"
}

List intermediate regions

List a state's intermediate geographic regions, the divisions IBGE drew in 2017 around a state's main cities to replace the old mesoregions.

Inputs

StatestatetextRequired
The Brazilian state. Pick it from the list, or use its two-letter code such as RJ.One of: AC (Acre (AC)), AL (Alagoas (AL)), AP (Amapá (AP)), AM (Amazonas (AM)), BA (Bahia (BA)), CE (Ceará (CE)), DF (Distrito Federal (DF)), ES (Espírito Santo (ES)), GO (Goiás (GO)), MA (Maranhão (MA)), and 17 more.

Outputs

countnumber
How many there are
regionslist
The intermediate regions, by code
state_codetext
The state's two-letter code
state_nametext
The state's name
Example output
{
  "count": 3,
  "regions": [
    {
      "id": 3301,
      "name": "Rio de Janeiro"
    },
    {
      "id": 3302,
      "name": "Volta Redonda - Barra Mansa"
    },
    {
      "id": 3303,
      "name": "Petr\u00f3polis"
    }
  ],
  "state_code": "RJ",
  "state_name": "Rio de Janeiro"
}

List metropolitan regions

List a state's metropolitan regions as its state law defines them, each with every municipality in it. Use it to decide whether an address is in Greater São Paulo or Greater Rio.

Inputs

StatestatetextRequired
The Brazilian state. Pick it from the list, or use its two-letter code such as RJ.One of: AC (Acre (AC)), AL (Alagoas (AL)), AP (Amapá (AP)), AM (Amazonas (AM)), BA (Bahia (BA)), CE (Ceará (CE)), DF (Distrito Federal (DF)), ES (Espírito Santo (ES)), GO (Goiás (GO)), MA (Maranhão (MA)), and 17 more.

Outputs

countnumber
How many there are
regionslist
The metropolitan regions, by name
state_codetext
The state's two-letter code
state_nametext
The state's name
Example output
{
  "count": 1,
  "regions": [
    {
      "id": "04701",
      "municipalities": [
        {
          "id": 3201308,
          "name": "Cariacica"
        },
        {
          "id": 3202207,
          "name": "Fund\u00e3o"
        },
        {
          "id": 3202405,
          "name": "Guarapari"
        },
        {
          "id": 3205002,
          "name": "Serra"
        },
        {
          "id": 3205101,
          "name": "Viana"
        },
        {
          "id": 3205200,
          "name": "Vila Velha"
        },
        {
          "id": 3205309,
          "name": "Vit\u00f3ria"
        }
      ],
      "municipality_count": 7,
      "name": "Regi\u00e3o Metropolitana da Grande Vit\u00f3ria"
    }
  ],
  "state_code": "ES",
  "state_name": "Esp\u00edrito Santo"
}

List municipalities

List municipalities in one state or in all of Brazil (5,571 of them), optionally only those whose name contains some text, with each one's 7-digit IBGE code and the regions it belongs to. Use it to build a lookup table or to turn a list of city names into codes.

Inputs

Statestatetext
Only municipalities in this state. Leave it empty for all of Brazil.One of: AC (Acre (AC)), AL (Alagoas (AL)), AP (Amapá (AP)), AM (Amazonas (AM)), BA (Bahia (BA)), CE (Ceará (CE)), DF (Distrito Federal (DF)), ES (Espírito Santo (ES)), GO (Goiás (GO)), MA (Maranhão (MA)), and 17 more.
Name containsname_containstext
Only municipalities whose name contains this text. Accents and capitals do not matter.
How many to returnlimitnumber
How many municipalities to return, in alphabetical order. Defaults to 100; 6000 returns every one.From 1 to 6000. Default: 100.

Outputs

countnumber
How many are in the result
matched_countnumber
How many matched before the limit
municipalitieslist
The municipalities, by name
name_containstext
The text the names were narrowed to
state_codetext
The state asked for, empty for all of Brazil
total_countnumber
How many municipalities the state or Brazil has
Example output
{
  "count": 2,
  "matched_count": 8,
  "municipalities": [
    {
      "id": 3300704,
      "immediate_region_id": 330013,
      "immediate_region_name": "Cabo Frio",
      "intermediate_region_id": 3305,
      "intermediate_region_name": "Maca\u00e9 - Rio das Ostras - Cabo Frio",
      "mesoregion_id": 3304,
      "mesoregion_name": "Baixadas",
      "microregion_id": 33010,
      "microregion_name": "Lagos",
      "name": "Cabo Frio",
      "region_code": "SE",
      "region_name": "Sudeste",
      "state_code": "RJ",
      "state_id": 33,
      "state_name": "Rio de Janeiro"
    },
    {
      "id": 3304300,
      "immediate_region_id": 330003,
      "immediate_region_name": "Rio Bonito",
      "intermediate_region_id": 3301,
      "intermediate_region_name": "Rio de Janeiro",
      "mesoregion_id": 3306,
      "mesoregion_name": "Metropolitana do Rio de Janeiro",
      "microregion_id": 33016,
      "microregion_name": "Macacu-Caceribu",
      "name": "Rio Bonito",
      "region_code": "SE",
      "region_name": "Sudeste",
      "state_code": "RJ",
      "state_id": 33,
      "state_name": "Rio de Janeiro"
    }
  ],
  "name_contains": "rio",
  "state_code": "RJ",
  "total_count": 92
}

List states

List Brazil's 26 states and the Federal District, or those of one region, with the two-letter code, IBGE's number for each and the region it belongs to.

Inputs

Regionregiontext
Only the states of this region. Leave it empty for all 27.One of: N (North (Norte)), NE (Northeast (Nordeste)), SE (Southeast (Sudeste)), S (South (Sul)), CO (Center-West (Centro-Oeste)).

Outputs

countnumber
How many states are in the result
region_codetext
The region asked for, empty for all of Brazil
region_nametext
The region's name, empty for all of Brazil
stateslist
The states, in alphabetical order
Example output
{
  "count": 3,
  "region_code": "SE",
  "region_name": "Sudeste",
  "states": [
    {
      "code": "ES",
      "id": 32,
      "name": "Esp\u00edrito Santo",
      "region_code": "SE",
      "region_id": 3,
      "region_name": "Sudeste"
    },
    {
      "code": "MG",
      "id": 31,
      "name": "Minas Gerais",
      "region_code": "SE",
      "region_id": 3,
      "region_name": "Sudeste"
    },
    {
      "code": "RJ",
      "id": 33,
      "name": "Rio de Janeiro",
      "region_code": "SE",
      "region_id": 3,
      "region_name": "Sudeste"
    }
  ]
}

List the release calendar

List what IBGE has scheduled to publish, soonest first: inflation, jobs, GDP and every other survey, from today or between two dates, for one survey or all of them. Use it to plan around the day new figures come out.

Inputs

Fromfrom_datedate
The first day to include. Leave it empty to start today.
Toto_datedate
The last day to include. Leave it empty for everything scheduled.
Surveysurveytext
Only items about this IBGE survey, such as the monthly PNAD or the IPCA. Pick it from the list, or give IBGE's survey number. Leave it empty for every survey.
How many to returnlimitnumber
How many to return at most. The result says how many matched in all. Defaults to 50.From 1 to 500. Default: 50.

Outputs

countnumber
How many are in the result
from_datetext
The first day included, as YYYY-MM-DD
matched_countnumber
How many are scheduled in the range in all
releaseslist
The scheduled releases, soonest first
survey_nametext
The survey asked for, empty for every survey
to_datetext
The last day included, empty for no end
Example output
{
  "count": 2,
  "from_date": "2026-10-21",
  "matched_count": 57,
  "releases": [
    {
      "category": "Produtos Geocient\u00edficos Experimentais",
      "id": 4573,
      "reference_end": "",
      "reference_start": "",
      "release_date": "2026-10-22",
      "survey_alias": "contas-de-ecossistemas",
      "survey_id": 28920,
      "survey_name": "Contas de Ecossistemas",
      "title": "Contas Econ\u00f4micas Ambientais - Contas de Ecossistemas: uma abordagem para Unidades de Conserva\u00e7\u00e3o",
      "url": ""
    },
    {
      "category": "Divulga\u00e7\u00e3o de Indicadores",
      "id": 4314,
      "reference_end": "",
      "reference_start": "2026-10",
      "release_date": "2026-10-23",
      "survey_alias": "indice-nacional-de-precos-ao-consumidor-amplo-15",
      "survey_id": 9260,
      "survey_name": "\u00cdndice Nacional de Pre\u00e7os ao Consumidor Amplo 15",
      "title": "\u00cdndice Nacional de Pre\u00e7os ao Consumidor Amplo 15",
      "url": ""
    }
  ],
  "survey_name": "",
  "to_date": ""
}

Rank the most common names

Get the 20 most common first names from the 2010 census, for all of Brazil, a state or a municipality, for people born in one decade, and for women or men.

Inputs

Decade of birthdecadetext
Only people born in this decade. Leave it empty for everyone.One of: before_1930 (Born before 1930), 1930s (Born in the 1930s), 1940s (Born in the 1940s), 1950s (Born in the 1950s), 1960s (Born in the 1960s), 1970s (Born in the 1970s), 1980s (Born in the 1980s), 1990s (Born in the 1990s), 2000s (Born in the 2000s).
Statestatetext
Only people in this state. Leave it empty for all of Brazil.One of: AC (Acre (AC)), AL (Alagoas (AL)), AP (Amapá (AP)), AM (Amazonas (AM)), BA (Bahia (BA)), CE (Ceará (CE)), DF (Distrito Federal (DF)), ES (Espírito Santo (ES)), GO (Goiás (GO)), MA (Maranhão (MA)), and 17 more.
Municipalitymunicipalitytext
Only people in this municipality. Choose the state to pick it from the list, or give its 7-digit code. Leave it empty for the whole state or country.
Sexsextext
Only women or only men. Leave it empty for everyone.One of: F (Women), M (Men).

Outputs

countnumber
How many names are in the ranking
decadetext
The decade of birth, or All decades
location_idtext
BR, or IBGE's code for the state or municipality
location_nametext
Where the people were counted
nameslist
The names, most common first
sextext
F or M when narrowed to women or men, else empty
Example output
{
  "count": 3,
  "decade": "1990s",
  "location_id": "35",
  "location_name": "S\u00e3o Paulo",
  "names": [
    {
      "count": 100875,
      "name": "ANA",
      "rank": 1
    },
    {
      "count": 88688,
      "name": "JESSICA",
      "rank": 2
    },
    {
      "count": 72495,
      "name": "BRUNA",
      "rank": 3
    }
  ],
  "sex": "F"
}

Search CNAE activities

Find the CNAE code for a kind of business from words that describe it, in Portuguese: 'padaria' finds bakeries that make their own bread and those that resell it. Searches both the subclass names and the thousands of activities filed under them.

Inputs

SearchsearchtextRequired
Words describing the activity, in Portuguese. Every word must appear; accents do not matter.
Sectionsectiontext
Only activities in this section. Leave it empty for all.One of: A (A: Agriculture, livestock, forestry and fishing), B (B: Mining and quarrying), C (C: Manufacturing), D (D: Electricity and gas), E (E: Water, sewage and waste), F (F: Construction), G (G: Trade and vehicle repair), H (H: Transport, storage and mail), I (I: Accommodation and food), J (J: Information and communication), and 11 more.
How many to returnlimitnumber
How many to return at most. The result says how many matched in all. Defaults to 25.From 1 to 200. Default: 25.

Outputs

activitieslist
The matching subclasses, name matches first
countnumber
How many are in the result
matched_countnumber
How many matched in all
searched_fortext
The words searched for
section_codetext
The section asked for, empty for all
Example output
{
  "activities": [
    {
      "class_name": "FABRICA\u00c7\u00c3O DE PRODUTOS DE PANIFICA\u00c7\u00c3O",
      "code": "1091102",
      "description": "FABRICA\u00c7\u00c3O DE PRODUTOS DE PADARIA E CONFEITARIA COM PREDOMIN\u00c2NCIA  DE PRODU\u00c7\u00c3O PR\u00d3PRIA",
      "division_name": "FABRICA\u00c7\u00c3O DE PRODUTOS ALIMENT\u00cdCIOS",
      "formatted_code": "1091-1/02",
      "matched_activity": "",
      "section_code": "C",
      "section_name": "IND\u00daSTRIAS DE TRANSFORMA\u00c7\u00c3O"
    },
    {
      "class_name": "COM\u00c9RCIO VAREJISTA DE PRODUTOS DE PADARIA, LATIC\u00cdNIO, DOCES, BALAS E SEMELHANTES",
      "code": "4721102",
      "description": "PADARIA E CONFEITARIA COM PREDOMIN\u00c2NCIA DE REVENDA",
      "division_name": "COM\u00c9RCIO VAREJISTA",
      "formatted_code": "4721-1/02",
      "matched_activity": "",
      "section_code": "G",
      "section_name": "COM\u00c9RCIO; REPARA\u00c7\u00c3O DE VE\u00cdCULOS AUTOMOTORES E MOTOCICLETAS"
    }
  ],
  "count": 2,
  "matched_count": 6,
  "searched_for": "padaria",
  "section_code": ""
}

Search news and releases

Search the IBGE news agency's stories and its releases of new figures (inflation, unemployment, GDP, harvests), newest first, by words, kind, survey and date. Each item comes with its headline, opening paragraph and link, in Portuguese.

Inputs

Searchsearchtext
Words to look for, in Portuguese. Accents do not matter. Leave it empty for everything.
Kindnews_typetext
News stories, or releases of new figures. Leave it empty for both.
Published on or afterpublished_fromdate
Only items published on this day or later.
Published on or beforepublished_todate
Only items published on this day or earlier.
Surveysurveytext
Only items about this IBGE survey, such as the monthly PNAD or the IPCA. Pick it from the list, or give IBGE's survey number. Leave it empty for every survey.
How many to returnlimitnumber
How many to return at most. The result says how many matched in all. Defaults to 20.From 1 to 100. Default: 20.

Outputs

countnumber
How many items are in the result
itemslist
The items, newest first
more_availabletrue/false
True when more items matched than were returned
news_typetext
news or release when narrowed to one kind, else empty
searched_fortext
The words searched for
survey_nametext
The survey asked for, empty for every survey
total_countnumber
How many items matched in all
Example output
{
  "count": 2,
  "items": [
    {
      "id": 48292,
      "image_url": "https://agenciadenoticias.ibge.gov.br/images/agenciadenoticias/releases/PMC_release.png",
      "introduction": "Em agosto de 2026, o volume de vendas no com\u00e9rcio varejista registrou varia\u00e7\u00e3o de 0,1% frente a julho, na s\u00e9rie com ajuste sazonal, ap\u00f3s queda de 0,8% em julho ...",
      "is_highlight": true,
      "published_date": "2026-10-15",
      "section": "economicas",
      "survey_id": 9227,
      "survey_name": "Pesquisa Mensal de Com\u00e9rcio",
      "title": "Em agosto, com\u00e9rcio varejista registra varia\u00e7\u00e3o de 0,1%",
      "type": "release",
      "url": "https://agenciadenoticias.ibge.gov.br/agencia-sala-de-imprensa/2013-agencia-de-noticias/releases/48292-em-agosto-comercio-varejista-registra-variacao-0-1.html"
    },
    {
      "id": 48289,
      "image_url": "https://agenciadenoticias.ibge.gov.br/images/agenciadenoticias/releases/LSPA_Release.png",
      "introduction": "A estimativa de setembro do IBGE para a produ\u00e7\u00e3o de gr\u00e3os em 2026 foi de 354,5 milh\u00f5es de toneladas, 2,4% (8,4 milh\u00f5es de toneladas) maior que a obtida em 2025 ...",
      "is_highlight": true,
      "published_date": "2026-10-15",
      "section": "economicas",
      "survey_id": 9201,
      "survey_name": "Levantamento Sistem\u00e1tico da Produ\u00e7\u00e3o Agr\u00edcola",
      "title": "Em setembro, safra prevista pelo IBGE para 2026 \u00e9 de 354,5 milh\u00f5es de toneladas",
      "type": "release",
      "url": "https://agenciadenoticias.ibge.gov.br/agencia-sala-de-imprensa/2013-agencia-de-noticias/releases/48289-em-setembro-safra-prevista-pelo-ibge-para-2026-e-de-354-5-milhoes-de-toneladas.html"
    }
  ],
  "more_available": true,
  "news_type": "release",
  "searched_for": "",
  "survey_name": "",
  "total_count": 4171
}

Search statistics tables

Find SIDRA tables, IBGE's published statistics, by words in the table's or its survey's name, optionally only those published for municipalities or states, or monthly. Each table comes with the number the other table actions take.

Inputs

SearchsearchtextRequired
Words from the table's name, in Portuguese. Every word must appear; accents do not matter and the start of a word is enough.
Published forleveltext
Only tables with figures for this kind of place. Leave it empty for any.One of: N1 (Brazil), N2 (Major regions), N3 (States), N6 (Municipalities), N7 (Metropolitan regions), N8 (Mesoregions), N9 (Microregions), N10 (Districts).
Frequencyfrequencytext
Only tables updated this often. Leave it empty for any.One of: P5 (Monthly), P13 (Rolling quarter), P9 (Quarterly), P8 (Every six months), P1 (Yearly).
How many to returnlimitnumber
How many to return at most. The result says how many matched in all. Defaults to 25.From 1 to 200. Default: 25.

Outputs

countnumber
How many are in the result
frequencytext
The frequency asked for, empty for any
leveltext
The kind of place asked for, empty for any
matched_countnumber
How many matched in all
searched_fortext
The words searched for
tableslist
The matching tables, best match first
Example output
{
  "count": 2,
  "frequency": "",
  "level": "",
  "matched_count": 3,
  "searched_for": "popula\u00e7\u00e3o residente estimada",
  "tables": [
    {
      "id": 6579,
      "name": "Popula\u00e7\u00e3o residente estimada",
      "survey_id": "XF",
      "survey_name": "Estimativas de Popula\u00e7\u00e3o",
      "url": "https://sidra.ibge.gov.br/tabela/6579"
    },
    {
      "id": 5456,
      "name": "Popula\u00e7\u00e3o residente estimada e pessoas de 10 anos ou mais de idade usu\u00e1rias da Internet, total e por 1.000 habitantes",
      "survey_id": "IU",
      "survey_name": "Indicadores de Desenvolvimento Sustent\u00e1vel",
      "url": "https://sidra.ibge.gov.br/tabela/5456"
    }
  ]
}

On this page