Skip to main content
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.
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.
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.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.