DANE

Las estadísticas oficiales del Departamento Administrativo Nacional de Estadística (DANE): el mercado laboral de la Gran Encuesta Integrada de Hogares (GEIH), la pobreza monetaria y multidimensional, y el Censo Nacional de Población y Vivienda de 2018, con cada territorio identificado por su código DIVIPOLA para cruzar las series con cualquier otra fuente por departamento o municipio. Cada serie está organizada y lista para consultar: la tasa de desocupación de una ciudad durante veinte años, la pobreza multidimensional de cada departamento o la distribución por estrato de las viviendas de un municipio, cada una 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.

Mercado laboral

POST /co/dane/labour-market/v1 Dataset Las series de mercado laboral, filtradas por cualquier combinación de territorio, indicador, tipo de periodo, dominio y fechas. El periodo más reciente primero.

Campo	Tipo	Notas
`territory_code`	string	Código DIVIPOLA opcional: 2 dígitos para un departamento (`44`), 5 para un municipio (`44001`). Un área metropolitana responde al código de su municipio núcleo.
`territory_level`	enum	Opcional: `national`, `region`, `department`, `metropolitan_area`, `city` o `city_aggregate` (un grupo de ciudades, p. ej. las 13 principales).
`indicator_code`	enum	Opcional: `unemployment_rate` (TD), `employment_rate` (TO), `participation_rate` (TGP), `underemployment_rate` (TS), `working_age_share`, las tasas combinadas de subutilización, o una población en miles (`population`, `labour_force`, `employed`, `unemployed`, …).
`period_type`	enum	Opcional: `monthly` (la nación y las 13 ciudades principales), `rolling_quarter` (trimestre móvil, 23 ciudades y áreas metropolitanas) o `rolling_year` (año móvil, 32 ciudades). Un periodo móvil se fecha por su último mes.
`domain`	enum	Opcional: `total` o `urban` (cabeceras, solo nacional).
`from_date`	string	Opcional. Primer mes (`yyyy-mm-dd`, cuenta el mes en que cae).
`to_date`	string	Opcional. Último mes (`yyyy-mm-dd`, inclusive).
`page`	integer	Opcional. Página, empieza en 1. Por defecto `1`.
`per_page`	integer	Opcional. Resultados por página, 1-500. Por defecto `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"
      }'

Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y results[].

Pobreza

POST /co/dane/poverty/v1 Dataset La pobreza monetaria y multidimensional, filtrada por territorio, indicador, dominio y años. El año más reciente primero.

Campo	Tipo	Notas
`territory_code`	string	Código DIVIPOLA opcional de 2 dígitos de un departamento, p. ej. `44` (La Guajira).
`territory_level`	enum	Opcional: `national`, `region` o `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` o `multidimensional_poverty_rate` (IPM).
`domain`	enum	Opcional: `total`, `urban` o `rural`. Solo la pobreza multidimensional se divide por dominio.
`year_from`	integer	Primer año opcional, inclusive. `0` no pone límite. Por defecto `0`.
`year_to`	integer	Último año opcional, inclusive. `0` no pone límite. Por defecto `0`.
`page`	integer	Opcional. Página, empieza en 1. Por defecto `1`.
`per_page`	integer	Opcional. Resultados por página, 1-500. Por defecto `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"
      }'

Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y results[].

IPM municipal

POST /co/dane/municipal-ipm/v1 Dataset La pobreza multidimensional del censo de 2018 de un municipio, de todos los municipios de un departamento, o de los municipios cuyo nombre coincide.

Campo	Tipo	Notas
`territory_code`	string	Código DIVIPOLA opcional: 5 dígitos para un municipio (`44001`), 2 para todos los municipios de un departamento (`44`).
`query`	string	Palabras opcionales del nombre del municipio, con o sin tildes, p. ej. `medellin`.
`page`	integer	Opcional. Página, empieza en 1. Por defecto `1`.
`per_page`	integer	Opcional. Resultados por página, 1-500. Por defecto `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" }'

Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y results[].

Censo por municipio

POST /co/dane/census-municipalities/v1 Dataset El perfil censal de 2018 de un municipio, de todos los municipios de un departamento, o de los municipios cuyo nombre coincide.

Campo	Tipo	Notas
`territory_code`	string	Código DIVIPOLA opcional: 5 dígitos para un municipio (`44001`), 2 para todos los municipios de un departamento (`44`).
`query`	string	Palabras opcionales del nombre del municipio, con o sin tildes, p. ej. `medellin`.
`page`	integer	Opcional. Página, empieza en 1. Por defecto `1`.
`per_page`	integer	Opcional. Resultados por página, 1-500. Por defecto `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" }'

Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y results[].

Respuesta

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

Mercado laboral y pobreza (`results[]`)

Campo	Notas
`series_id`	La identidad de la observación.
`territory_code`	Código DIVIPOLA, o null para la nación, las regiones y los grupos de ciudades.
`territory_name`, `territory_level`	El territorio como lo nombra el DANE, y su tipo.
`domain`	`total`, `urban` o `rural`.
`indicator_code`, `indicator`	El indicador, y su nombre en el DANE.
`unit`	`percent`, `thousands_of_people`, `cop_per_month` (pesos corrientes por persona al mes) o `coefficient` (Gini).
`period`, `period_type`, `period_start`	Solo mercado laboral: el mes (`yyyy-mm`), o el último mes de un trimestre o año móvil.
`year`	El año medido.
`value`	El valor tal como lo publicó el DANE.
`release`	La publicación de la que sale el valor.
`document_url`, `source_document_url`	`document_url` es el libro de Excel de DANE del que sale el valor, tal como DANE lo publicó y siempre disponible en ese enlace; `source_document_url` es el mismo libro en DANE.

IPM municipal (`results[]`)

territory_code, territory_name, department_code, department_name, year (2018), ipm, ipm_urban, ipm_rural (porcentaje de personas en hogares en pobreza multidimensional), deprivations[] (indicator_code, indicator, total, urban, rural para cada una de las quince privaciones), document_url y source_document_url.

Censo por municipio (`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 (grupos de diez años), education, households, dwellings (por tipo y ocupación), services (energía, acueducto, alcantarillado, gas, recolección de basuras, internet), estrato (viviendas según el estrato en que se les factura la energía: e1 a e6 y unknown) y units (residenciales, mixtas, no residenciales y lugares especiales de alojamiento). Todos son conteos.

La pobreza monetaria por departamento cubre 23 departamentos y Bogotá: el DANE no la publica para Amazonas, Arauca, Casanare, Guainía, Guaviare, Putumayo, San Andrés, Vaupés y Vichada. La pobreza multidimensional cubre los 33. El mercado laboral nacional excluye las zonas no capitales de la Amazonía y la Orinoquía, como lo hace el DANE.

Referencia completa

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

Primeros pasos

Tipos de solicitud

Monitores

Países

Mercado laboral

Pobreza

IPM municipal

Censo por municipio

Respuesta

Mercado laboral y pobreza (`results[]`)

IPM municipal (`results[]`)

Censo por municipio (`results[]`)

Referencia completa

​Mercado laboral

​Pobreza

​IPM municipal

​Censo por municipio

​Respuesta

​Mercado laboral y pobreza (results[])

​IPM municipal (results[])

​Censo por municipio (results[])

Referencia completa

Mercado laboral

Pobreza

IPM municipal

Censo por municipio

Respuesta

Mercado laboral y pobreza (`results[]`)

IPM municipal (`results[]`)

Censo por municipio (`results[]`)