DNP TerriData

TerriData es el panel de estadísticas territoriales del Departamento Nacional de Planeación (DNP). Reúne, para Colombia, sus 32 departamentos y cada municipio, los indicadores que publican el DANE, los ministerios y otras entidades: pobreza monetaria y multidimensional, cobertura y resultados educativos, cobertura en salud y mortalidad, mercado laboral, finanzas públicas municipales y departamentales, delitos, vivienda y servicios públicos, demografía, ambiente y más. Cada valor conserva la entidad que lo produjo. Todo el panel, organizado y listo para consultar: el perfil completo de un territorio, la historia de un indicador, o todos los municipios ordenados por un indicador, cada uno en una sola llamada rápida.

La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye as_of: qué tan actualizados están los datos. Cómo funcionan los datasets.

Buscar indicadores

POST /co/terridata/indicators-search/v1 Dataset Encuentra indicadores por nombre y dimensión. Empieza aquí para obtener el código que usan los demás endpoints.

Campo	Tipo	Notas
`query`	string	Opcional. Palabras a buscar en el nombre del indicador, p. ej. `pobreza multidimensional`.
`dimension_code`	enum	Opcional. Dimensión de dos dígitos, p. ej. `14` pobreza, `04` educación, `05` salud, `16` mercado laboral, `07` finanzas públicas.
`page`	integer	Opcional. Página, empieza en 1. Por defecto `1`.
`per_page`	integer	Opcional. Resultados por página, 1-100. Por defecto `20`.

curl https://api.croma.run/co/terridata/indicators-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "pobreza multidimensional" }'

Devuelve as_of, los filtros aplicados, total, total_is_exact, page, per_page, total_pages, count e indicators[] (ver abajo).

Series por territorio

POST /co/terridata/series/v1 Dataset Devuelve los indicadores de un territorio, cada uno con el valor de todos sus años.

Campo	Tipo	Notas
`territory_code`	string	Obligatorio. Código DANE de cinco dígitos: un municipio (`05001` Medellín), un departamento (`05000` Antioquia) o `01001` para Colombia.
`indicator_code`	string	Opcional. El código de nueve dígitos de un indicador, de la búsqueda de indicadores.
`dimension_code`	enum	Opcional. Dimensión de dos dígitos, p. ej. `14` pobreza, `04` educación, `05` salud, `16` mercado laboral, `07` finanzas públicas.
`query`	string	Opcional. Palabras a buscar en el nombre del indicador, p. ej. `pobreza multidimensional`.
`page`	integer	Opcional. Página, empieza en 1. Por defecto `1`.
`per_page`	integer	Opcional. Resultados por página, 1-100. Por defecto `20`.

curl https://api.croma.run/co/terridata/series/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "territory_code": "05001", "dimension_code": "14" }'

Devuelve as_of, found, el territorio, los filtros aplicados, total, total_is_exact, page, per_page, total_pages, count y series[] (ver abajo).

Ranking

POST /co/terridata/ranking/v1 Dataset Compara todos los municipios o departamentos en un indicador.

Campo	Tipo	Notas
`indicator_code`	string	Obligatorio. El código de nueve dígitos del indicador, de la búsqueda de indicadores.
`year`	integer	Opcional. El año a comparar, p. ej. `2024`. `0` (por defecto) compara el valor más reciente de cada territorio. Por defecto `0`.
`level`	enum	Opcional. `municipality` (por defecto) o `department`. Por defecto `municipality`.
`department_code`	string	Opcional. Código DANE de dos dígitos: solo los municipios de ese departamento.
`order`	enum	Opcional. `desc` (mayor primero, por defecto) o `asc`. Por defecto `desc`.
`page`	integer	Opcional. Página, empieza en 1. Por defecto `1`.
`per_page`	integer	Opcional. Resultados por página, 1-100. Por defecto `20`.

curl https://api.croma.run/co/terridata/ranking/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "indicator_code": "140030015", "per_page": 10 }'

Devuelve as_of, found, el indicador con su unidad y entidad, los filtros aplicados, total, page, per_page, total_pages, count y results[] (ver abajo).

Respuesta

Cada respuesta incluye as_of: qué tan actualizados están los datos.

`series[]`

Campo	Notas
`series_id`	`<territory_code>-<indicator_code>`.
`territory_code`, `territory_name`, `territory_level`	El territorio: código DANE de cinco dígitos, nombre, y `country`, `department` o `municipality`.
`department_code`, `department_name`	Su departamento (`01`, `Colombia` para la nación).
`indicator_code`, `indicator`	Código de nueve dígitos y nombre del indicador.
`dimension_code`, `dimension`, `subcategory`	Dónde se ubica el indicador en el panel.
`unit`	Unidad de medida (`Porcentaje`, `Número`, `Pesos corrientes`, …).
`data_source`	La entidad que produjo la cifra (`DANE`, `MEN`, `DNP`, …).
`first_year`, `last_year`	Los años que abarca la serie.
`latest_value`, `latest_text`	El valor más reciente, como número o como texto.
`observations[]`	Todos los valores, del más antiguo al más reciente: `{ year, month, value, text }`. `month` viene cuando la cifra es mensual o tomada a un corte.

`indicators[]`

indicator_code, indicator, dimension_code, dimension, subcategory, unit, data_source, territories y municipalities (cuántos lo reportan), first_year, last_year y observations (cuántos valores tiene el panel para él).

`results[]` (ranking)

rank, territory_code, territory_name, department_code, department_name, year, month y value. Los números son números; los nombres, unidades y categorías quedan en español tal como los escribe la fuente.

Referencia completa

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

Primeros pasos

Tipos de solicitud

Monitores

Países

Buscar indicadores

Series por territorio

Ranking

Respuesta

`series[]`

`indicators[]`

`results[]` (ranking)

Referencia completa

​Buscar indicadores

​Series por territorio

​Ranking

​Respuesta

​series[]

​indicators[]

​results[] (ranking)

Referencia completa

Buscar indicadores

Series por territorio

Ranking

Respuesta

`series[]`

`indicators[]`

`results[]` (ranking)