> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# IBGE
> Las estadísticas oficiales de Brasil del IBGE: encuentra cualquiera de sus más de 9.000 tablas (desempleo e ingresos de la PNAD Contínua, inflación IPCA, PIB municipal, Censo 2022) y lee sus valores por país, región, estado o municipio.
El Instituto Brasileiro de Geografia e Estatística (IBGE) publica las
estadísticas oficiales de Brasil como tablas agregadas: más de 9.000, de
unas 70 encuestas y censos. La PNAD Contínua para desempleo, ingresos e
informalidad; el IPCA y el INPC para la inflación; el PIB de los
municipios; el Censo Demográfico 2022 para cada municipio; encuestas
agropecuarias e industriales.
Busca en el catálogo por palabras, encuesta, tema, periodicidad o nivel
territorial para encontrar una tabla y sus variables, y luego lee sus
valores para los períodos y territorios que necesitas. Los territorios usan
los códigos del IBGE: el código de 2 dígitos del estado y el de 7 dígitos
del municipio, el mismo que otras fuentes brasileñas traen como
`municipality_code`.
## Buscar tablas
`POST /br/ibge/tables-search/v1` Dataset
Encuentra tablas por palabras, encuesta, tema, periodicidad o nivel territorial.
| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Opcional. Palabras del título, la encuesta, el tema o las variables de la tabla, en portugués, p. ej. `taxa de desocupação`. |
| `survey` | string | Opcional. El `survey_id` de dos caracteres de la encuesta (p. ej. `DD` PNAD Contínua trimestral, `IA` IPCA, `CD` Censo Demográfico) o su nombre completo. |
| `subject` | string | Opcional. El tema como lo nombra el IBGE, p. ej. `Trabalho`, `Índices de preços`. Se ignoran mayúsculas y tildes. |
| `periodicity` | string | Opcional. `monthly`, `quarterly`, `annual`, u otra periodicidad que muestre un resultado. |
| `territory_level` | enum | Opcional. Solo tablas con datos a nivel `country`, `region`, `state` o `municipality`. |
| `table_id` | string | Opcional. Una tabla por su número, p. ej. `4099`. |
| `page` | integer | Opcional. Página, desde 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Tablas por página, 1-20. Por defecto `10`. |
```bash theme={"dark"}
curl https://api.croma.run/br/ibge/tables-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "taxa de desocupação",
"territory_level": "state",
"per_page": 5
}'
```
Cada tabla es `{ table_id, name, survey_id, survey, subject, periodicity, period_start, period_end, territory_levels, variables, classifications, source_url }`.
* `variables`: `{ variable_id, name, unit }`; pasa los ids a `ibge-table-values` en `variable_ids`.
* `classifications`: los desgloses que ofrece la tabla (sexo, grupo de edad, producto, sección CNAE...), cada uno `{ classification_id, name, categories }`, cada categoría `{ category_id, name, level }` (`level` 0 es el total). Pásalos a `ibge-table-values` en `classifications`.
* `territory_levels`: `country`, `region`, `state`, `municipality`, y niveles más finos o especiales como `metro_area`, `mesoregion` o `microregion`.
* `period_start` y `period_end`: los códigos de período que cubre la tabla, `yyyy` en tablas anuales, `yyyymm` en mensuales, `yyyy0q` en trimestrales (`202602` es el segundo trimestre de 2026).
## Valores de una tabla
`POST /br/ibge/table-values/v1` Devuelve los valores de una tabla para las variables, períodos, territorios y categorías pedidos.
| Campo | Tipo | Notas |
| - | - | - |
| `table_id` | string | **Obligatorio.** El número de la tabla, p. ej. `4099` (tasa de desocupación de la PNAD Contínua). La búsqueda de arriba lo encuentra. |
| `variable_ids` | string | Opcional. Números de variable separados por comas, p. ej. `4099`. Vacío devuelve todas las variables de la tabla. |
| `period` | string | Opcional. `latest`, un período (`2023`, `202609` para un mes, `202602` para un trimestre) o un rango, p. ej. `202401-202604`. Por defecto `latest`. |
| `territory_level` | enum | Opcional. `country`, `region`, `state` o `municipality`. La tabla debe tener datos en ese nivel. Por defecto `country`. |
| `territory_code` | string | Opcional. Códigos IBGE separados por comas: los 2 dígitos de un estado (`35`), los 7 de un municipio (`3550308`). Vacío devuelve todos los territorios del nivel. |
| `classifications` | string | Opcional. Pares `clasificación:categorías` separados por `;`, p. ej. `315:7170,7171` o `2:all`. Una clasificación omitida devuelve su total. |
```bash theme={"dark"}
curl https://api.croma.run/br/ibge/table-values/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"table_id": "4099",
"variable_ids": "4099",
"period": "latest",
"territory_level": "country"
}'
```
Devuelve `found`, el `table_name`, `survey` y `periodicity` de la tabla, los `periods` cubiertos (`{ period, name }`), las `variables` (`{ variable_id, name, unit }`), `count` y `values`. Cada valor es `{ territory_level, territory_code, territory_name, variable_id, period, value, value_note, unit, categories }`.
* `value`: un número, o null cuando IBGE no publica ninguno para esa celda. `value_note` dice entonces por qué: `not_applicable`, `not_available` o `suppressed` (omitido para proteger a los informantes). Un cero verdadero es `0` con `value_note: "zero"`.
* `categories`: la categoría de cada clasificación a la que pertenece el valor, `{ classification_id, category_id, category_name }`. Una clasificación no pedida vuelve con su total.
* `found` es false, sin valores, cuando la tabla no existe o no tiene nada para el período pedido.
Una llamada devuelve como máximo 15.000 valores (territorios x variables x
períodos x categorías). Una solicitud mayor se rechaza con
`too_many_results`: acota `territory_code`, `variable_ids`, `period` o
`classifications`, o divídela.
Esquemas, todos los campos de respuesta y un playground interactivo.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.