IBGE Getting Started: Accessing Brazilian Data (2026)

Getting started overview

Integrating with the Instituto Brasileiro de Geografia e Estatística (IBGE) primarily involves identifying and consuming official Brazilian statistical and geospatial data. Unlike commercial API platforms that often provide unified RESTful endpoints for many services, IBGE's data access strategy is distributed. Users typically interact with specific web services, data portals, or direct file downloads hosted on the official IBGE website. The process focuses on data discovery and retrieval rather than a universal API key integration model.

This guide outlines the steps to navigate IBGE's resources, create any necessary accounts, and execute a foundational data request. The emphasis is on understanding IBGE's approach to data dissemination, which prioritizes public access to comprehensive national statistics and geographical information rather than a developer-centric API product for geocoding commercial applications.

Quick-reference steps:

Create an account and get keys

For many of its public datasets and publications, IBGE does not require an account or API keys. Direct access to data files (e.g., CSV, Shapefile, PDF) and statistical tables is often available through the IBGE website's data and publications sections. This approach contrasts with commercial API providers that typically gate access behind API key authentication, as described in guides like the Google Maps Platform API key best practices.

However, some specialized services or systems within IBGE may require registration for authenticated access. These are often related to specific research collaborations, internal government projects, or advanced data querying tools. To determine if an account is necessary for your specific use case, navigate to the relevant data portal or service on the IBGE website and look for registration prompts or access requirements in the documentation.

If registration is required, the process generally involves:

1. Locating the Registration Link: This will be on the specific service's landing page.
2. Providing Personal/Organizational Details: Information such as name, email, and affiliation may be requested.
3. Agreeing to Terms of Use: Review and accept any data usage policies.
4. Email Verification: A confirmation email may be sent to verify your address.

IBGE does not widely employ a universal API key system comparable to services like Stripe API keys or Cloudflare API tokens for general data access. Instead, authentication, if needed, is typically session-based or tied to specific service credentials.

Your first request

Executing your first request with IBGE depends entirely on the specific data product or service you intend to use. Given the diverse nature of IBGE's offerings, a "first request" might involve a direct file download, an HTTP GET request to a specific web service endpoint, or interaction with an online data query interface.

Example 1: Direct Data Download

Many of IBGE's most sought-after datasets, such as census results, demographic indicators, and geographical shapefiles, are available for direct download. This is often the simplest "first request."

1. Navigate to the Data Catalog: On the IBGE homepage, find sections like "Estatísticas" (Statistics) or "Geociências" (Geosciences).
2. Locate a Dataset: For instance, search for "Censo Demográfico" (Demographic Census) or "Mapas e Dados Geográficos" (Maps and Geographic Data).
3. Identify Download Links: Within the dataset's page, look for links to download files in formats like CSV, XLS, or SHP.
4. Download the Data: Click the link to initiate the download.

This method doesn't involve programmatic API calls but effectively retrieves data from IBGE.

Example 2: Web Service Request (IPCA data)

IBGE provides structured web services for certain types of data, particularly economic indicators. For example, the Sistema Nacional de Índices de Preços ao Consumidor (SNIPC) offers data on the IPCA (Índice Nacional de Preços ao Consumidor Amplo – Broad National Consumer Price Index).

While a comprehensive API documentation portal like Google Geocoding API documentation is not centrally available for all IBGE web services, specific endpoints exist. One common access pattern for statistical tables is via URLs that specify parameters.

Endpoint Example (Illustrative - verify current endpoint on IBGE site):

GET https://servicodados.ibge.gov.br/api/v3/agregados/{id_agregado}/periodos/{periodo}/variaveis/{id_variavel}

To make a request for, for example, the IPCA index (agregado ID 63) for the last 12 months (periodo -3), and a specific variable:

curl -X GET "https://servicodados.ibge.gov.br/api/v3/agregados/63/periodos/-3/variaveis" -H "Accept: application/json"

This curl command makes an HTTP GET request to a specific IBGE data service endpoint. The -H "Accept: application/json" header requests the response in JSON format. The response would contain JSON data representing the requested IPCA values.

Key steps for a web service request:

1. Identify the Service: Locate the specific web service and its base URL on the IBGE website, typically in sections related to specific statistics (e.g., "Preços e Custos" for price indices).
2. Understand Parameters: Review any available documentation to understand required parameters (e.g., aggregate ID, period, variable ID).
3. Construct the URL: Assemble the full endpoint URL with the necessary parameters.
4. Execute Request: Use a tool like curl, a programming language's HTTP client, or a web browser to make the GET request.

Common next steps

Once you have successfully retrieved your first dataset or made a web service call, consider these common next steps:

1. Data Exploration and Analysis: Load the retrieved data into a spreadsheet, database, or a data analysis tool (e.g., Python with Pandas, R) to begin exploring its contents. Familiarize yourself with the data schema, variable definitions, and geographic scope.
2. Automated Data Retrieval: For ongoing projects, automate the data retrieval process using scripting languages (e.g., Python, R) to fetch data from IBGE's web services or download updated files periodically. This often involves scheduling scripts to run at specific intervals.
3. Geospatial Integration: If you've downloaded geospatial data (e.g., shapefiles of municipalities), integrate it with Geographic Information Systems (GIS) software like QGIS or ArcGIS. This allows for spatial analysis, mapping, and visualization of Brazilian geographical features alongside statistical data. For a general overview of GIS capabilities, refer to resources like ArcGIS Developers documentation.
4. Explore Other Datasets: IBGE offers a vast array of statistics and geographical information. Explore other categories relevant to your research, such as agricultural statistics, industrial surveys, or social indicators.
5. Monitor for Updates: Statistical data is updated regularly. Subscribe to IBGE's newsletters or frequently check the official website for announcements regarding new releases, updated datasets, or changes to web service endpoints.
6. Consult Documentation: For complex datasets or web services, thoroughly review the methodology, metadata, and technical documentation provided by IBGE to ensure correct interpretation and use of the data.

Troubleshooting the first call

Troubleshooting issues when accessing IBGE data often relates to data discovery, URL construction, or understanding specific service limitations. Here are common scenarios and solutions:

• "Data not found" or empty response:

  • Check Dataset Availability: Verify that the specific dataset or statistical aggregate you are looking for is currently available and has not been moved or retired on the IBGE website.
  • Parameter Accuracy: If using a web service, double-check all parameters (e.g., aggregate IDs, variable IDs, periods) for correctness against IBGE's documentation. Slight misspellings or incorrect IDs can lead to errors.

• Incorrect or unexpected data format:

  • Verify "Accept" Header: Ensure your HTTP request includes the correct Accept header (e.g., Accept: application/json) if you expect a specific format from a web service.
  • Check Download File Type: If downloading, confirm the file extension matches your expectation (e.g., .csv vs. .xls).

• "Access Denied" or authentication errors:

  • Service Requires Account: Some specialized IBGE services may require an authenticated session or specific credentials. Revisit the service's page on the IBGE website to confirm registration requirements.
  • Session Expiration: If you are logged into a specific IBGE portal, your session might have expired. Try logging in again.

• Slow response times or timeouts:

  • Server Load: IBGE's servers can experience high load, especially during major data releases. Consider retrying your request during off-peak hours.
  • Large Data Volume: If requesting a very large dataset via a web service, the request might time out. Look for options to filter or paginate the data if the service supports it.

• Issues with geospatial data files (e.g., shapefiles):

  • Missing Components: Shapefiles consist of multiple files (e.g., .shp, .shx, .dbf). Ensure all necessary components are downloaded and kept together in the same directory for your GIS software to read them correctly.
  • Projection Mismatch: When importing into GIS, ensure the coordinate reference system (CRS) of the IBGE data matches or is properly transformed to your project's CRS.