IBGE Statistical Tables Search

Search the catalog of Brazil's official statistics from IBGE: 9,000+ aggregate tables from PNAD Contínua, IPCA, PIB dos Municípios, Censo Demográfico and some 70 other surveys. Filter by words in the title, survey or variables, subject, periodicity or territorial level. Each table returns its periodicity, the periods it covers, the levels it has data for (country, region, state, municipality...), its variables with units and its classifications with their categories: everything ibge-table-values needs. Refreshed weekly.

Dataset endpoint: answers from the whole source in milliseconds and carries as_of.

post/br/ibge/tables-search/v1

Request

Base URL: https://api.croma.run
URL: https://api.croma.run/br/ibge/tables-search/v1
Auth: HTTP bearer

Headers

Idempotency-Keystring

Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Request body

querystring

Words to find in the table's name, its survey, its subject or its variables, e.g. desocupação (optional).

surveystring

The survey, by the two-character survey_id a search result returns (e.g. DD for PNAD Contínua trimestral, IA for IPCA) or by its full name, e.g. Censo Demográfico; case and accents ignored (optional).

subjectstring

The subject, as IBGE names it, e.g. Trabalho or Índices de preços; case and accents ignored (optional).

periodicitystring

How often the table is published: monthly, quarterly, annual, and the rarer periodicities a search result shows (optional).

territory_level'' | 'country' | 'region' | 'state' | 'municipality'

Only tables with data at this level: country, region, state or municipality (optional).

table_idstring

One table by its number, e.g. 4099 (optional).

pageinteger

1-based page number for paginated results.

per_pageinteger

Tables per page (1-20).

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.