DANE

As estatísticas oficiais do Departamento Administrativo Nacional de Estadística (DANE): o mercado de trabalho da pesquisa domiciliar (GEIH), a pobreza monetária e multidimensional, e o censo nacional de 2018, com cada território identificado pelo seu código DIVIPOLA para cruzar as séries com qualquer outra fonte por departamento ou município. Cada série está organizada e pronta para consultar: a taxa de desocupação de uma cidade ao longo de vinte anos, a pobreza multidimensional de cada departamento ou a distribuição por estrato dos domicílios de um município, cada uma 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.

Mercado de trabalho

POST /co/dane/labour-market/v1 Dataset As séries do mercado de trabalho, filtradas por qualquer combinação de território, indicador, tipo de período, domínio e datas. O período mais recente primeiro.

Campo	Tipo	Notas
`territory_code`	string	Código DIVIPOLA opcional: 2 dígitos para um departamento (`44`), 5 para um município (`44001`). Uma área metropolitana responde ao código do seu município núcleo.
`territory_level`	enum	Opcional: `national`, `region`, `department`, `metropolitan_area`, `city` ou `city_aggregate` (um grupo de cidades, p. ex. as 13 principais).
`indicator_code`	enum	Opcional: `unemployment_rate` (TD), `employment_rate` (TO), `participation_rate` (TGP), `underemployment_rate` (TS), `working_age_share`, as taxas combinadas de subutilização, ou uma população em milhares (`population`, `labour_force`, `employed`, `unemployed`, …).
`period_type`	enum	Opcional: `monthly` (a nação e as 13 cidades principais), `rolling_quarter` (trimestre móvel, 23 cidades e áreas metropolitanas) ou `rolling_year` (ano móvel, 32 cidades). Um período móvel é datado pelo seu último mês.
`domain`	enum	Opcional: `total` ou `urban` (cabeceras, só nacional).
`from_date`	string	Opcional. Primeiro mês (`yyyy-mm-dd`, conta o mês em que cai).
`to_date`	string	Opcional. Último mês (`yyyy-mm-dd`, inclusive).
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `100`.

curl https://api.croma.run/co/dane/labour-market/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "indicator_code": "unemployment_rate",
        "territory_level": "national",
        "period_type": "monthly",
        "domain": "total",
        "from_date": "2025-01-01"
      }'

Retorna as_of (o quão atuais são os dados), os filtros aplicados, total e total_is_exact, page, per_page, total_pages, count e results[].

Pobreza

POST /co/dane/poverty/v1 Dataset A pobreza monetária e multidimensional, filtrada por território, indicador, domínio e anos. O ano mais recente primeiro.

Campo	Tipo	Notas
`territory_code`	string	Código DIVIPOLA opcional de 2 dígitos de um departamento, p. ex. `44` (La Guajira).
`territory_level`	enum	Opcional: `national`, `region` ou `department`.
`indicator_code`	enum	Opcional: `monetary_poverty_rate`, `monetary_poverty_persons`, `extreme_poverty_rate`, `extreme_poverty_persons`, `gini`, `income_per_capita`, `poverty_line`, `extreme_poverty_line` ou `multidimensional_poverty_rate` (IPM).
`domain`	enum	Opcional: `total`, `urban` ou `rural`. Só a pobreza multidimensional é dividida por domínio.
`year_from`	integer	Primeiro ano opcional, inclusive. `0` não define limite. Por padrão `0`.
`year_to`	integer	Último ano opcional, inclusive. `0` não define limite. Por padrão `0`.
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `100`.

curl https://api.croma.run/co/dane/poverty/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "territory_code": "44",
        "indicator_code": "multidimensional_poverty_rate",
        "domain": "total"
      }'

Retorna as_of (o quão atuais são os dados), os filtros aplicados, total e total_is_exact, page, per_page, total_pages, count e results[].

IPM municipal

POST /co/dane/municipal-ipm/v1 Dataset A pobreza multidimensional do censo de 2018 de um município, de todos os municípios de um departamento, ou dos municípios cujo nome coincide.

Campo	Tipo	Notas
`territory_code`	string	Código DIVIPOLA opcional: 5 dígitos para um município (`44001`), 2 para todos os municípios de um departamento (`44`).
`query`	string	Palavras opcionais do nome do município, com ou sem acentos, p. ex. `medellin`.
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `100`.

curl https://api.croma.run/co/dane/municipal-ipm/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "territory_code": "44001" }'

Retorna as_of (o quão atuais são os dados), os filtros aplicados, total e total_is_exact, page, per_page, total_pages, count e results[].

Censo por município

POST /co/dane/census-municipalities/v1 Dataset O perfil censitário de 2018 de um município, de todos os municípios de um departamento, ou dos municípios cujo nome coincide.

Campo	Tipo	Notas
`territory_code`	string	Código DIVIPOLA opcional: 5 dígitos para um município (`44001`), 2 para todos os municípios de um departamento (`44`).
`query`	string	Palavras opcionais do nome do município, com ou sem acentos, p. ex. `medellin`.
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `100`.

curl https://api.croma.run/co/dane/census-municipalities/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "territory_code": "44001" }'

Retorna as_of (o quão atuais são os dados), os filtros aplicados, total e total_is_exact, page, per_page, total_pages, count e results[].

Resposta

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

Mercado de trabalho e pobreza (`results[]`)

Campo	Notas
`series_id`	A identidade da observação.
`territory_code`	Código DIVIPOLA, ou null para a nação, as regiões e os grupos de cidades.
`territory_name`, `territory_level`	O território como o DANE o nomeia, e o seu tipo.
`domain`	`total`, `urban` ou `rural`.
`indicator_code`, `indicator`	O indicador, e o seu nome no DANE.
`unit`	`percent`, `thousands_of_people`, `cop_per_month` (pesos correntes por pessoa ao mês) ou `coefficient` (Gini).
`period`, `period_type`, `period_start`	Só mercado de trabalho: o mês (`yyyy-mm`), ou o último mês de um trimestre ou ano móvel.
`year`	O ano medido.
`value`	O valor como o DANE o publicou.
`release`	A publicação de onde sai o valor.
`document_url`, `source_document_url`	`document_url` é a planilha do DANE de onde sai o valor, exatamente como o DANE a publicou e sempre disponível nesse link; `source_document_url` é a mesma planilha no DANE.

IPM municipal (`results[]`)

territory_code, territory_name, department_code, department_name, year (2018), ipm, ipm_urban, ipm_rural (percentual de pessoas em domicílios em pobreza multidimensional), deprivations[] (indicator_code, indicator, total, urban, rural para cada uma das quinze privações), document_url e source_document_url.

Censo por município (`results[]`)

territory_code, territory_name, department_code, department_name, year (2018), latitude, longitude, area_km2, population (total, men, women, in_households, in_group_quarters), age (faixas de dez anos), education, households, dwellings (por tipo e ocupação), services (energia, água, esgoto, gás, coleta de lixo, internet), estrato (domicílios pelo estrato em que a energia é faturada: e1 a e6 e unknown) e units (residenciais, mistas, não residenciais e alojamentos coletivos). Todos são contagens.

A pobreza monetária por departamento cobre 23 departamentos e Bogotá: o DANE não a publica para Amazonas, Arauca, Casanare, Guainía, Guaviare, Putumayo, San Andrés, Vaupés e Vichada. A pobreza multidimensional cobre os 33. O mercado de trabalho nacional exclui as zonas não capitais da Amazônia e da Orinoquía, como faz o DANE.

Referência completa

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

Primeiros passos

Tipos de solicitação

Monitores

Países

Mercado de trabalho

Pobreza

IPM municipal

Censo por município

Resposta

Mercado de trabalho e pobreza (`results[]`)

IPM municipal (`results[]`)

Censo por município (`results[]`)

Referência completa

​Mercado de trabalho

​Pobreza

​IPM municipal

​Censo por município

​Resposta

​Mercado de trabalho e pobreza (results[])

​IPM municipal (results[])

​Censo por município (results[])

Referência completa

Mercado de trabalho

Pobreza

IPM municipal

Censo por município

Resposta

Mercado de trabalho e pobreza (`results[]`)

IPM municipal (`results[]`)

Censo por município (`results[]`)