📊 IBGE Brazil Statistics Scraper

🚀 Export the official Brazilian statistical catalogue in seconds. Pull 27 states, 5,500+ municipalities, the full SIDRA aggregate catalogue, observation data, available periods, and aggregate metadata across the entire IBGE catalogue. No sign-up needed.

🕒 Last updated: 2026-05-15 · 📊 22 fields per record · 📦 4,000+ SIDRA aggregates · 🇧🇷 5,500+ municipalities · 27 states · 5 regions

The IBGE Brazil Statistics Scraper taps the official Brazilian Institute of Geography and Statistics catalogue and returns clean, structured records covering the full SIDRA aggregate library plus the official territorial reference (states, municipalities, regions, mesoregions, microregions). Pull aggregate names, subjects, frequencies, variables, units, periods, and observation values keyed by territorial level (N1 country, N2 region, N3 state, N6 municipality, N7 mesoregion).

Coverage spans every Brazilian municipality (5,500+), every state and federal district, IBGE administrative regions, and 4,000+ SIDRA aggregates including IPCA inflation, PNAD employment, GDP, demographic census, agricultural surveys, industrial production, foreign trade, and tourism. This Actor turns the territorial reference, full aggregate catalogue, single-aggregate metadata, available periods, and observation data into downloadable CSV, Excel, JSON, or XML in minutes.

🎯 Target Audience	💡 Primary Use Cases
Economists, journalists, banking & insurance teams, real estate analysts, researchers, BI engineers, civic-tech developers, NGOs	Inflation tracking, municipal demographic dashboards, agribusiness research, ML feature engineering, Power BI / Tableau feeds, newsroom charts, public-health research

---

📋 What the IBGE Brazil Scraper does

Five workflows in a single Actor:

• 🗺️ Localidades mode. Pull the official IBGE territorial reference: 27 states, 5,500+ municipalities, 5 regions, mesoregions, or microregions. Each record includes the IBGE numeric ID, padded ID string, sigla, name, region nesting, and a deep link to the official cidades-e-estados page.
• 📚 Aggregados mode. List every SIDRA aggregate with name, subject, and source URL — or pass a single aggregate ID to pull its full metadata block (variables, classifications, territorial levels, frequency).
• 📈 Data mode. Pull observation values for one or many aggregates by period, variable, and territorial level. Each row carries the variable label, unit, locality, and period.
• 🧾 Metadata mode. Get the variable + unit list for one aggregate or batch up to 100 aggregates in a single run.
• 📅 Periods mode. List every available period for one or many aggregates with last-modified timestamps.

Every record carries the official SIDRA deep link (sidra.ibge.gov.br/tabela/{id}), so you can verify any number against the source page in one click.

💡 Why it matters: Brazilian official statistics underpin lending decisions, agribusiness analytics, public-health research, real-estate underwriting, and journalism. Building your own pipeline against the SIDRA catalogue means handling territorial codes, classification cross-products, and Portuguese-only labels by hand. This Actor skips all of that and keeps your dataset fresh on every run.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
mode	enum	"aggregados"	One of localidades, aggregados, data, metadata, periods.
localidadesType	enum	"estados"	One of estados, municipios, regioes, mesorregioes, microrregioes.
aggregateId	string	""	SIDRA aggregate ID (e.g. 1685). Required for data mode.
aggregateIds	array	[]	Batch lookup for data, metadata, periods modes. Up to 100 IDs per run.
period	string	"all"	Period code for data mode (e.g. 2021, "202101", or "all").
variable	string	"allxp"	Variable ID for data mode. "allxp" = all variables.
level	enum	"N3"	Territorial level: N1 Brazil, N2 Region, N3 State, N6 Municipality, N7 Mesoregion.
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan at 1,000,000.

Example: full list of 27 Brazilian states.

{
    "mode": "localidades",
    "localidadesType": "estados",
    "maxItems": 30
}

Example: latest IPCA inflation (aggregate 1419) by state for 2026-04.

{
    "mode": "data",
    "aggregateId": "1419",
    "period": "202604",
    "variable": "63",
    "level": "N3",
    "maxItems": 30
}

⚠️ Good to Know: SIDRA aggregate IDs are integers (e.g. 1419 = IPCA inflation, 1685 = municipal GDP). Use aggregados mode first to discover IDs, then metadata mode to learn the variables and classifications, then data mode to pull observations. Territorial levels: N1 = Brazil (1 row), N2 = 5 regions, N3 = 27 states, N6 = 5,500+ municipalities.

---

📊 Output

Each record contains up to 22 fields depending on mode. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
🆔 id	integer	35
🆔 idString	string	"0000035"
🔗 url	string	"https://www.ibge.gov.br/cidades-e-estados/sp.html"
🏷️ sigla	string	"SP"
📛 nome	string	"São Paulo"
🌎 regiao	object	{ "id": 3, "sigla": "SE", "nome": "Sudeste" }
🏛️ microrregiao	object	{ "id": 35001, "nome": "Jales" }
🏛️ mesorregiao	object	{ "id": 3501, "nome": "São José do Rio Preto" }
🆔 aggregateId	integer	1419
📛 aggregateName	string	"IPCA - Variação mensal, acumulada no ano..."
🆔 variavelId	integer	63
📛 variavel	string	"IPCA - Variação mensal"
📐 unidade	string	"%"
🗺️ localidadeId	string	"35"
🗺️ localidadeNome	string	"São Paulo"
🆔 nivelId	string	"N3"
📛 nivelNome	string	"Unidade da Federação"
📅 periodo	string	"202604"
💰 valor	number	0.61
📝 valorRaw	string	"0.61"
🏷️ classificacoes	array	[{ "id": 315, "nome": "Geral", "categoria": { "7169": "Índice geral" } }]
🕒 scrapedAt	ISO 8601	"2026-05-15T10:00:00.000Z"

📦 Sample record (localidades mode, estados)

---

✨ Why choose this Actor

	Capability
🇧🇷	Full Brazilian coverage. 5,500+ municipalities, 27 states, 5 regions, plus mesoregions and microregions.
📚	4,000+ SIDRA aggregates. IPCA, PNAD, GDP, agricultural surveys, industrial production, demographic census, and more.
🧾	Batch metadata. Up to 100 aggregates' variables, units, and periods in a single run.
📈	Multi-level data. Pull observations at country, region, state, municipality, or mesoregion granularity.
🔁	Always fresh. Every run reflects the current state of the official catalogue.
🧰	No setup. No sign-up, no key, no scraping CSS selectors.
🔗	Source-anchored. Every record carries the official SIDRA or cidades-e-estados deep link.

📊 IBGE is the most-cited reference for Brazilian inflation, employment, GDP, demographic census, and agricultural data. This Actor makes it queryable in seconds.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ IBGE Brazil Scraper (this Actor)	$5 free credit, then pay-per-use	5,500+ municipios, 4,000+ aggregates	Live per run	localidades, aggregados, data, metadata, periods	⚡ 2 min
Manual SIDRA downloads	Free	Per-aggregate only	Manual	None	🐢 Hours per aggregate
Macro-data terminals	$24,000+/year	Curated subset	Live	Many	⏳ Days
Build your own pipeline	Engineering hours	What you build	What you build	What you build	🕒 Weeks

Pick this Actor when you want broad Brazilian coverage, multi-level granularity, and no parser maintenance.

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the IBGE Brazil Statistics Scraper page on the Apify Store.
3. 🎯 Set input. Pick a mode (start with aggregados to browse the catalogue), set maxItems, and click Start.
4. 🚀 Run it. Click Start and let the Actor collect your data.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

🏦 Banking, fintech, and insurance Live IPCA inflation feeds for retail-rate dashboards in Brazil Mortgage and insurance underwriting fed by PNAD employment data Macro-forecasting models with quarterly GDP estimates Risk dashboards aligned with IBGE official numbers	🏘️ PropTech and real estate Municipal demographic and household projections for site selection State-level wage and employment data for valuation models Construction output and housing-starts indicators Demographic shifts feeding tenant-targeting
🌾 Agribusiness and commodities Municipal agricultural production by crop and livestock Seasonal harvest tracking by state and region Industrial production and producer-price indicators Trade and export data for commodity desks	📰 Journalism and policy Live charts of inflation, jobs, and GDP for newsrooms Municipal explainers backed by census data Public-policy briefs with cited, versioned numbers Investigative reporting on health, security, and demographics

---

🔌 Automating IBGE Brazil Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Daily refreshes for high-frequency aggregates (IPCA, PNAD, industrial production) keep dashboards current with no engineering effort.

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Macroeconomic theses with cited, versioned data pulls Public-health and demographic research at the municipal level Reproducible studies with stable SIDRA aggregate IDs Open-data exercises in econometrics and stats courses	🎨 Personal and creative Side projects, indie data dashboards, and portfolio demos Interactive Brazil maps, inflation trackers, and visualizations Content research for data journalists and creators Hobbyist time-series for forecasters and analysts
🤝 Non-profit and civic Equity research on regional income, housing, and labour outcomes Civic transparency on public spending and services Investigative journalism backed by IBGE official numbers Open data community contributions and visualizations	🧪 Experimentation Train forecasting and anomaly-detection ML models Validate macro hypotheses with real time-series Prototype agent pipelines that resolve aggregate IDs Test BI dashboard concepts with live Brazilian data

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick a mode (localidades, aggregados, data, metadata, periods), set the SIDRA aggregate ID or locality type, and click Start. The Actor pulls clean structured records straight from the official IBGE catalogue. No browser automation, no captchas, no setup.

📏 How accurate is the data?

Every value comes directly from the official IBGE catalogue, the canonical source for Brazilian official statistics. No transformation is applied beyond field-name normalization and ISO timestamp stamping.

🔁 How often is the catalogue refreshed?

The catalogue is updated continuously as IBGE releases new aggregates and revises existing ones. Every run of this Actor returns the live state of the catalogue.

🗺️ How do I pull municipal-level data?

Set level to N6 (Municipality) in data mode. With 5,500+ Brazilian municipalities, raise maxItems accordingly. Use localidades mode with localidadesType: "municipios" to first pull the full municipality reference and resolve IBGE codes.

⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to run this Actor on any cron interval (hourly, daily, weekly) and keep your downstream database in sync with new IBGE releases.

⚖️ Is this data legal to use?

IBGE publishes its data under terms that permit free reuse with attribution to IBGE. Review the licence terms for your specific use case.

💼 Can I use this data commercially?

Yes. The underlying IBGE data is open and permits commercial use with attribution. You are responsible for complying with the licence and with any downstream regulatory requirements.

💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and gives you access to scheduling, higher concurrency, and larger datasets.

🔁 What happens if a run fails or gets interrupted?

Apify automatically retries transient errors. If a run still fails, you can inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress.

🔢 How do I find SIDRA aggregate IDs?

Use aggregados mode with no aggregateId to list every published SIDRA aggregate. Each record has the integer ID, name, and subject. Common examples: 1419 = IPCA monthly inflation, 1685 = municipal GDP, 4093 = PNAD employment.

🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

---

🔌 Integrate with any app

IBGE Brazil Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications in your channels
• Airbyte - Pipe IBGE records into your warehouse
• n8n - Self-hosted workflow automation
• Pipedream - Event-driven serverless workflows
• GitHub - Trigger runs from commits and releases
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh IPCA or PNAD numbers into your product backend, or alert your team in Slack the minute a new release lands.

---

🔗 Recommended Actors

• 📊 INE Spain Scraper - Spanish National Statistics Institute
• 📊 INE Portugal Scraper - Statistics Portugal indicators
• 📊 ONS UK Statistics Scraper - UK Office for National Statistics datasets
• 📊 Statistics Canada Scraper - Canadian official statistics catalogue
• 📈 Indexmundi Scraper - Global demographic and economic indicators

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by the Instituto Brasileiro de Geografia e Estatística or the Government of Brazil. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.