DNP TerriData

TerriData é o painel de estatísticas territoriais do Departamento Nacional de Planeación (DNP) da Colômbia. Reúne, para o país, seus 32 departamentos e cada município, os indicadores que o DANE, os ministérios e outros órgãos publicam: pobreza monetária e multidimensional, cobertura e resultados escolares, cobertura de saúde e mortalidade, mercado de trabalho, finanças públicas municipais e departamentais, crimes, moradia e serviços públicos, demografia, meio ambiente e mais. Cada valor mantém o órgão que o produziu. O painel inteiro, organizado e pronto para consultar: o perfil completo de um território, a história de um indicador, ou todos os municípios ordenados por um indicador, cada um em uma única chamada rápida.

A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz as_of: o quão atuais são os dados. Como funcionam os datasets.

Buscar indicadores

POST /co/terridata/indicators-search/v1 Dataset Encontra indicadores por nome e dimensão. Comece aqui para obter o código que os demais endpoints usam.

Campo	Tipo	Notas
`query`	string	Opcional. Palavras a buscar no nome do indicador, em espanhol, p. ex. `pobreza multidimensional`.
`dimension_code`	enum	Opcional. Dimensão de dois dígitos, p. ex. `14` pobreza, `04` educação, `05` saúde, `16` mercado de trabalho, `07` finanças públicas.
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-100. Por padrão `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" }'

Retorna as_of, os filtros aplicados, total, total_is_exact, page, per_page, total_pages, count e indicators[] (ver abaixo).

Séries por território

POST /co/terridata/series/v1 Dataset Retorna os indicadores de um território, cada um com o valor de todos os seus anos.

Campo	Tipo	Notas
`territory_code`	string	Obrigatório. Código DANE de cinco dígitos: um município (`05001` Medellín), um departamento (`05000` Antioquia) ou `01001` para a Colômbia.
`indicator_code`	string	Opcional. O código de nove dígitos de um indicador, da busca de indicadores.
`dimension_code`	enum	Opcional. Dimensão de dois dígitos, p. ex. `14` pobreza, `04` educação, `05` saúde, `16` mercado de trabalho, `07` finanças públicas.
`query`	string	Opcional. Palavras a buscar no nome do indicador, em espanhol, p. ex. `pobreza multidimensional`.
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-100. Por padrão `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" }'

Retorna as_of, found, o território, os filtros aplicados, total, total_is_exact, page, per_page, total_pages, count e series[] (ver abaixo).

Ranking

POST /co/terridata/ranking/v1 Dataset Compara todos os municípios ou departamentos em um indicador.

Campo	Tipo	Notas
`indicator_code`	string	Obrigatório. O código de nove dígitos do indicador, da busca de indicadores.
`year`	integer	Opcional. O ano a comparar, p. ex. `2024`. `0` (padrão) compara o valor mais recente de cada território. Por padrão `0`.
`level`	enum	Opcional. `municipality` (padrão) ou `department`. Por padrão `municipality`.
`department_code`	string	Opcional. Código DANE de dois dígitos: apenas os municípios desse departamento.
`order`	enum	Opcional. `desc` (maior primeiro, padrão) ou `asc`. Por padrão `desc`.
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-100. Por padrão `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 }'

Retorna as_of, found, o indicador com sua unidade e órgão, os filtros aplicados, total, page, per_page, total_pages, count e results[] (ver abaixo).

Resposta

Cada resposta traz as_of: o quão atuais são os dados.

`series[]`

Campo	Notas
`series_id`	`<territory_code>-<indicator_code>`.
`territory_code`, `territory_name`, `territory_level`	O território: código DANE de cinco dígitos, nome, e `country`, `department` ou `municipality`.
`department_code`, `department_name`	Seu departamento (`01`, `Colombia` para a nação).
`indicator_code`, `indicator`	Código de nove dígitos e nome do indicador, em espanhol.
`dimension_code`, `dimension`, `subcategory`	Onde o indicador se situa no painel.
`unit`	Unidade de medida, em espanhol (`Porcentaje`, `Número`, `Pesos corrientes`, …).
`data_source`	O órgão que produziu o número (`DANE`, `MEN`, `DNP`, …).
`first_year`, `last_year`	Os anos que a série abrange.
`latest_value`, `latest_text`	O valor mais recente, como número ou como texto.
`observations[]`	Todos os valores, do mais antigo ao mais recente: `{ year, month, value, text }`. `month` vem quando o número é mensal ou tomado em um corte.

`indicators[]`

indicator_code, indicator, dimension_code, dimension, subcategory, unit, data_source, territories e municipalities (quantos o reportam), first_year, last_year e observations (quantos valores o painel tem para ele).

`results[]` (ranking)

rank, territory_code, territory_name, department_code, department_name, year, month e value. Números são números; nomes, unidades e categorias ficam em espanhol como a fonte os escreve.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Tipos de solicitação

Monitores

Países

Buscar indicadores

Séries por território

Ranking

Resposta

`series[]`

`indicators[]`

`results[]` (ranking)

Referência completa

​Buscar indicadores

​Séries por território

​Ranking

​Resposta

​series[]

​indicators[]

​results[] (ranking)

Referência completa

Buscar indicadores

Séries por território

Ranking

Resposta

`series[]`

`indicators[]`

`results[]` (ranking)