Mintrabajo - Croma API

Las estadísticas del mercado de trabajo del Ministerio de Trabajo y Previsión Social de Guatemala (Dirección de Estadística Laboral): los indicadores de las encuestas de hogares del INE (ENEI, ENCOVI y la ENEIC trimestral) para el país y por sexo, dominio, edad, pueblo, actividad y categoría ocupacional; los afiliados cotizantes al IGSS por departamento, actividad y mes desde 2017; el salario mínimo nominal y real desde 1995 para las dos circunscripciones económicas; el modelo de riesgo de trabajo infantil (MIRTI) de los 340 municipios; y cada informe, boletín y archivo de datos que publica el Ministerio, conservado por Croma. Cada serie está organizada y lista para consultar: la tasa de desempleo de las mujeres en cada ronda, el empleo formal de un departamento mes a mes o el salario mínimo que pagaba una maquila en 2019, 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.

Indicadores del mercado laboral

POST /gt/mintrabajo-gt/labour-indicators/v1 Dataset Los indicadores de las encuestas, filtrados por encuesta, desagregación y años. La ronda más reciente primero; dentro de una ronda, total y luego las categorías de cada desagregación.

Campo	Tipo	Notas
`survey`	enum	Opcional: `ENEI` (2012-2022), `ENEIC` (trimestral desde 2024-T4) o `ENCOVI` (2023).
`breakdown`	enum	Opcional: `total`, `sex`, `area` (metropolitano, resto urbano, rural), `age_group`, `ethnicity`, `economic_activity` o `occupational_category`. Las filas de actividad y categoría describen a los ocupados.
`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/gt/mintrabajo-gt/labour-indicators/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "breakdown": "sex", "year_from": 2024 }'

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[].

Afiliados al IGSS

POST /gt/mintrabajo-gt/igss-contributors/v1 Dataset Afiliados cotizantes por departamento, actividad y mes. El mes más reciente primero.

Campo	Tipo	Notas
`department_code`	string	Código opcional del departamento, dos dígitos, `01` (Guatemala) a `22` (Jutiapa), en el orden en que los numera el INE.
`activity`	enum	Opcional: `agricultural`, `export_and_maquila`, `non_agricultural` (el resto del sector privado) o `public`.
`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/gt/mintrabajo-gt/igss-contributors/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "department_code": "01",
        "activity": "non_agricultural",
        "from_date": "2026-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[].

Salario mínimo

POST /gt/mintrabajo-gt/minimum-wage/v1 Dataset El salario mínimo en quetzales al mes, nominal por año y real por mes. El más reciente primero.

Campo	Tipo	Notas
`measure`	enum	Opcional: `nominal` (una fila por año y actividad, el salario vigente) o `real` (una fila por mes, deflactado por el índice de precios al consumidor). Ambos si se omite.
`activity`	enum	Opcional: `agricultural`, `non_agricultural` o `export_and_maquila` (publicado desde 2008).
`circumscription`	enum	Opcional: `CE1` (el departamento de Guatemala) o `CE2` (los otros 21 departamentos). Solo difieren en 2014 y desde 2023.
`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/gt/mintrabajo-gt/minimum-wage/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "measure": "nominal", "year_from": 2020 }'

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[].

Riesgo de trabajo infantil

POST /gt/mintrabajo-gt/child-labour-risk/v1 Dataset Los municipios de un departamento o región, los de un nivel de riesgo, o aquellos cuyo nombre coincide. La mayor prevalencia estimada primero.

Campo	Tipo	Notas
`department_code`	string	Código opcional del departamento, dos dígitos, `01` (Guatemala) a `22` (Jutiapa), en el orden en que los numera el INE.
`region_code`	integer	Región opcional, 1 (Metropolitana) a 8 (Petén). `0` no filtra. Por defecto `0`.
`risk_level`	integer	Nivel de riesgo nacional opcional, 1 (muy bajo) a 5 (muy alto). `0` no filtra. Por defecto `0`.
`query`	string	Palabras opcionales del nombre del municipio o del departamento, con o sin tildes, p. ej. `coban`.
`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/gt/mintrabajo-gt/child-labour-risk/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "department_code": "16" }'

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[].

Informes y archivos de datos

POST /gt/mintrabajo-gt/publications-search/v1 Dataset Los documentos que publica el Ministerio, por palabras de su título o sección. El modificado más recientemente primero.

Campo	Tipo	Notas
`query`	string	Palabras opcionales a buscar en el título, la descripción o la sección, p. ej. `empleador 2025`.
`format`	enum	Opcional: `pdf` (informes y boletines) o `zip` (archivos de datos y sintaxis).
`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/gt/mintrabajo-gt/publications-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "trabajo infantil" }'

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.

Indicadores laborales (`results[]`)

Campo	Notas
`series_id`	La identidad de la fila: encuesta, ronda, desagregación y categoría.
`survey`, `year`, `period`, `period_start`	La ronda de la encuesta: `ENEI` 2012-2022 (de una a tres rondas al año, “2019-2”), `ENCOVI` 2023, `ENEIC` trimestral desde 2024 (“2026-T1”). `period_start` ordena las rondas.
`breakdown`, `category`	`total`, o la dimensión y la categoría dentro de ella, como la nombra la encuesta.
`population`, `working_age_population`, `labour_force`, `employed`, `unemployed`, `informal_employed`, `underemployed`	Personas ponderadas.
`working_age_share`, `participation_rate`, `employment_rate`, `unemployment_rate`, `informality_rate`, `underemployment_rate`	Porcentaje, dos decimales.
`average_income`	Ingreso laboral mensual promedio de los ocupados, en quetzales.

Afiliados al IGSS (`results[]`)

contributor_id, period (yyyy-mm), period_start, year, department_code, department, activity (agricultural, export_and_maquila, non_agricultural, public), activity_name, sector, circumscription y contributors.

Salario mínimo (`results[]`)

wage_id, measure (nominal por año, real por mes), period, period_start, year, month, activity, activity_name, circumscription (CE1 el departamento de Guatemala, CE2 el resto) y amount en quetzales al mes.

Riesgo de trabajo infantil (`results[]`)

municipality_code (los cuatro dígitos del INE), municipality, department_code, department, region_code, region, children, children_in_child_labour, prevalence con prevalence_lower y prevalence_upper (porcentaje), standard_error, coefficient_of_variation, estimate_quality, national_risk_level y national_risk (1 a 5 frente al país), regional_risk_level y regional_risk (frente a la región del municipio).

Publicaciones (`results[]`)

publication_id, title, description, headings[] y section (dónde lista la página el archivo), file_name, format, bytes, modified_at, source_document_url (el enlace del Ministerio), document_url (la copia idéntica byte a byte de Croma, siempre disponible) y document_versions[] cuando el Ministerio reemplazó el archivo en el mismo enlace.

Los indicadores laborales son las cifras del propio Ministerio a partir de las encuestas de hogares del INE. Las rondas no son estrictamente comparables entre encuestas: la ENEI, la ENCOVI y la ENEIC difieren en diseño y trabajo de campo, y las etiquetas de actividad económica y de pueblo siguen el codebook de cada encuesta.

Referencia completa

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