Checking status…
Catalog / ILOSTAT
ilostat

ILOSTAT

Open · redistributedCreative Commons Attribution 4.0 (CC BY 4.0)labour

Full-coverage grouped ingest of ILOSTAT (International Labour Organization). ILOSTAT exposes every indicator through the rplumber bulk API: - TOC of ALL indicators: /metadata/toc/indicator (1,947 indicator-frequency datasets) - bulk data per indicator: /data/indicator?id=<ID>&format=.parquet Each…

Redistributable. This source is served as canonical Parquet under the license below, with attribution and provenance preserved.

Coverage

Series catalogued
80
Temporal coverage
1947-12-31 – 2025-12-31
Frequencies
Annual
Distinct geographies
16
Categories
labour
Measured observations
388,164,886

Licensing & provenance

License
Creative Commons Attribution 4.0 (CC BY 4.0)
License URL
https://creativecommons.org/licenses/by/4.0/
Required attribution
Source: ILOSTAT (CC BY 4.0)
Redistribution
Permitted (served here)
Commercial use
Yes
Modification
Permitted

How to cite

International Labour Organization, ILOSTAT. Retrieved from https://ilostat.ilo.org. Compiled and redistributed by the Elkassabgi Data Library.

Processing: Retrieved from the official source, normalized to a long {series_key, obs_date, value} schema (period-start dates), de-duplicated, and stored as zstd Parquet. Compiled and redistributed by the Elkassabgi Data Library.

Access & mirrors

Download
Select & download ilostat series as CSV →
API
Get a free API key, then GET /v1/series/<id>.csv
Canonical landing
https://econdatalibrary.com/ilostat.html
Update cadence
monthly
Update strategy
bulk snapshot if changed
Storage layout
per-indicator-frequency files: data/clean_full/ilostat/<id>.parquet (observed 1947 files, one per TOC indicator-frequency id). Rich schema: series_key, ref_area, source, sex, classif1, classif2, obs_date(date32), time, value, obs_status. Plus run state in data/raw/ilostat/_manifest.csv and TOC in data/raw/ilostat/toc_indicator_en.csv.

Full description

Full-coverage grouped ingest of ILOSTAT (International Labour Organization). ILOSTAT exposes every indicator through the rplumber bulk API: - TOC of ALL indicators: /metadata/toc/indicator (1,947 indicator-frequency datasets) - bulk data per indicator: /data/indicator?id=<ID>&format=.parquet Each "id" is an indicator+frequency code (e.g. SDG_0111_SEX_AGE_RT_A, the trailing _A/_Q/_M is the frequency). A single bulk pull returns every country / sex / classification / source combination for that indicator -- the full long-format table whose row count equals the TOC's n.records (best_source=yes). We write ONE grouped Parquet per indicator-id to data/clean_full/ilostat/<id>.parquet: columns: series_key, ref_area, source, sex, classif1, classif2, obs_date (date32), time (orig period string), value, obs_status series_key = ilostat:<indicator>:<ref_area>:<sex>:<classif1>:<classif2>:<source> (empty dimension segments collapse, so e.g. ilostat:SDG_0552_NOC_RT:AGO::::BA:13951). license: cc-by-4.0 (configs/sources.yaml -> ilostat). A run manifest (data/raw/ilostat/_manifest.csv) records per-id status + rows so the run is idempotent (re-running skips completed ids) and verifiable against the TOC. Usage: python jobs/ingest_ilostat.py --toc # (re)download the indicator TOC only python jobs/ingest_ilostat.py --dry 5 # parse 5 ids, print, no writes python jobs/ingest_ilostat.py # full run (all 1,947 ids) python jobs/ingest_ilostat.py --workers 6 # set concurrency (default 6)

Structured metadata

schema.org/Dataset (Google Dataset Search)
{
  "@context": "https://schema.org/",
  "@type": "Dataset",
  "name": "ILOSTAT",
  "description": "Full-coverage grouped ingest of ILOSTAT (International Labour Organization). ILOSTAT exposes every indicator through the rplumber bulk API: - TOC of ALL indicators: /metadata/toc/indicator (1,947 indicator-frequency datasets) - bulk data per indicator: /data/indicator?id=<ID>&format=.parquet Each…",
  "url": "https://econdatalibrary.com/ilostat.html",
  "identifier": "ilostat",
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "creator": {
    "@type": "Organization",
    "name": "ILOSTAT"
  },
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "keywords": [
    "labour",
    "ilostat"
  ],
  "temporalCoverage": "1947-12-31/2025-12-31",
  "repeatFrequency": "P1Y",
  "creditText": "Source: ILOSTAT (CC BY 4.0)",
  "citation": "International Labour Organization, ILOSTAT. Retrieved from https://ilostat.ilo.org. Compiled and redistributed by the Elkassabgi Data Library.",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-ilostat",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "distribution": [
    {
      "@type": "DataDownload",
      "encodingFormat": "text/csv",
      "contentUrl": "https://econdatalibrary.com/download.html?source=ilostat",
      "license": "https://creativecommons.org/licenses/by/4.0/"
    }
  ]
}
Croissant (ML-ready, schema.org JSON-LD)
{
  "@context": {
    "@language": "en",
    "@vocab": "https://schema.org/",
    "cr": "http://mlcommons.org/croissant/",
    "data": {
      "@id": "cr:data",
      "@type": "@json"
    },
    "dataType": {
      "@id": "cr:dataType",
      "@type": "@vocab"
    },
    "sc": "https://schema.org/",
    "conformsTo": "dct:conformsTo",
    "dct": "http://purl.org/dc/terms/"
  },
  "@type": "sc:Dataset",
  "conformsTo": "http://mlcommons.org/croissant/1.0",
  "name": "ilostat",
  "description": "Full-coverage grouped ingest of ILOSTAT (International Labour Organization). ILOSTAT exposes every indicator through the rplumber bulk API: - TOC of ALL indicators: /metadata/toc/indicator (1,947 indicator-frequency datasets) - bulk data per indicator: /data/indicator?id=<ID>&format=.parquet Each…",
  "url": "https://econdatalibrary.com/ilostat.html",
  "creator": {
    "@type": "sc:Organization",
    "name": "ILOSTAT"
  },
  "publisher": {
    "@type": "sc:Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "keywords": [
    "labour"
  ],
  "temporalCoverage": "1947-12-31/2025-12-31",
  "citation": "International Labour Organization, ILOSTAT. Retrieved from https://ilostat.ilo.org. Compiled and redistributed by the Elkassabgi Data Library.",
  "distribution": [
    {
      "@type": "cr:FileObject",
      "@id": "ilostat-csv",
      "name": "ilostat-csv",
      "description": "Per-series CSV, downloadable with a free API key.",
      "contentUrl": "https://econdatalibrary.com/download.html?source=ilostat",
      "encodingFormat": "text/csv"
    }
  ]
}
Part of the Econ Data Library catalog · metadata generated 2026-07-14 from the central registry · browse all datasets
ElkassabgiData

One account. Every library.

HF Data Library  ·  Econ Data Library  · more to come