# ILOSTAT

> Read the International Labour Organization's labour statistics with no account or API key: unemployment, labour force participation, employment, earnings and minimum wages, working hours, informal work and labour income for about 230 countries and the world's regions, yearly, quarterly or monthly, by sex, age and other breakdowns. Search indicators, get values over time or a country's latest, and rank countries.

App · 7 actions. Web page: https://docs.lodol.com/docs/integrations/ilostat

## Actions

### Compare countries

Rank countries on one ILOSTAT indicator in one year, or at each one's latest value: all of them or the ones you pick, highest or lowest first. Regions such as World can be ranked too, and countries asked for with no value are listed as missing.

**Inputs**

- Indicator (`indicator`, text, required): What to measure. Pick from the list (the headline figures come first) or type an ILOSTAT indicator id, such as one Search indicators found.
- Year (`year`, number): Compare values for this year. Empty for each country's most recent, which can be a different year for each; for ILO modelled estimates that is a projection a year or two ahead. From 1900 to 2100.
- Countries (`countries`, list): Which countries to compare. Empty for every country ILOSTAT has a value for.
- Sex (`sex`, text): Total, female or male. Ignored for an indicator with no sex breakdown. One of: `total`, `female`, `male`. Default: `total`.
- Breakdown (`breakdown`, list): Values of the indicator's other breakdowns to read, such as an age band, an economic activity or a currency. Empty for each one's total; a breakdown with no total, such as currency, needs one value picked here.
- Order (`order`, text): Highest first by default. Lowest first suits an indicator where small is good, such as the unemployment rate. One of: `highest_first` (Highest first), `lowest_first` (Lowest first). Default: `highest_first`.
- Include regions (`include_regions`, true/false): On, regions and income groups such as World or Sub-Saharan Africa are ranked too. Off, only countries, unless named in Countries. Default: `false`.
- How many (`limit`, number): How many to list, from the top: 1 to 400. Empty for all. From 1 to 400.

**Outputs**

- `as_of` (text): The year compared, or each one's latest year.
- `attribution` (text): The credit ILOSTAT's licence (CC BY 4.0) asks for wherever the figures are published.
- `breakdowns_used` (text): Which breakdown values were compared.
- `count` (number): How many countries are listed.
- `countries` (list): The countries, ranked.
- `frequency` (text): The series read: annual, quarterly or monthly.
- `indicator` (text): The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
- `label` (text): What the indicator measures, e.g. Unemployment rate by sex and age (%).
- `leader` (text): The country ranked first.
- `leader_value` (number): Its value.
- `missing` (list): Countries asked for that have no value.
- `order` (text): highest_first or lowest_first.
- `sex` (text): The sex compared: Total, Female or Male.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many countries have a value.
- `unit` (text): The unit values are in, e.g. %, hours, persons or local currency.
- `unit_multiplier` (text): thousands or millions when values are counted in them (Employment 31,000 in thousands is 31 million people). Empty when values are as they are.
- `url` (text): The indicator in ILOSTAT's data explorer.
- `year` (number): The year compared. Empty for each one's latest.

**Example output**

```json
{
  "as_of": "2023",
  "attribution": "Source: ILOSTAT, International Labour Organization (ILO). Licensed under CC BY 4.0.",
  "breakdowns_used": "total age",
  "count": 3,
  "countries": [
    {
      "breakdown": "Age (Youth, adults): 15+",
      "country": "Germany",
      "country_code": "DEU",
      "rank": 1,
      "source": "LFS - EU Labour Force Survey",
      "status": null,
      "value": 2.978,
      "year": 2023
    },
    {
      "breakdown": "Age (Youth, adults): 15+",
      "country": "United States of America",
      "country_code": "USA",
      "rank": 2,
      "source": "LFS - Current Population Survey",
      "status": null,
      "value": 3.638,
      "year": 2023
    },
    {
      "breakdown": "Age (Youth, adults): 15+",
      "country": "France",
      "country_code": "FRA",
      "rank": 3,
      "source": "LFS - Employment Survey",
      "status": null,
      "value": 7.335,
      "year": 2023
    }
  ],
  "frequency": "annual",
  "indicator": "UNE_DEAP_SEX_AGE_RT",
  "label": "Unemployment rate by sex and age (%)",
  "leader": "Germany",
  "leader_value": 2.978,
  "missing": [],
  "order": "lowest_first",
  "sex": "Total",
  "summary": "Germany ranks first of 3 countries on Unemployment rate by sex and age (%) (2023), at 2.978%.",
  "total": 3,
  "unit": "%",
  "unit_multiplier": null,
  "url": "https://rplumber.ilo.org/dataexplorer/?id=UNE_DEAP_SEX_AGE_RT_A&lang=en",
  "year": 2023
}
```

### Get a country's latest value

Get the most recent value of one ILOSTAT indicator for one country or region, returned flat so a later step can read the number directly, with its year, source and notes. A country with no value comes back with found set to false rather than failing the step. ILO modelled estimates run a year or two ahead, so their latest value is a projection.

**Inputs**

- Indicator (`indicator`, text, required): What to measure. Pick from the list (the headline figures come first) or type an ILOSTAT indicator id, such as one Search indicators found.
- Country (`country`, text, required): The country or region. Pick from the list, or type a name or its three-letter code, such as KEN.
- Frequency (`frequency`, text): Yearly, quarterly or monthly figures. Empty for yearly, or the only series an indicator has. One of: `annual` (Yearly), `quarterly`, `monthly`.
- Sex (`sex`, text): Total, female or male. Ignored for an indicator with no sex breakdown. One of: `total`, `female`, `male`. Default: `total`.
- Breakdown (`breakdown`, list): Values of the indicator's other breakdowns to read, such as an age band, an economic activity or a currency. Empty for each one's total; a breakdown with no total, such as currency, needs one value picked here.

**Outputs**

- `attribution` (text): The credit ILOSTAT's licence (CC BY 4.0) asks for wherever the figures are published.
- `breakdown` (text): What else the value is for, e.g. an age band.
- `breakdown_code` (text): The same as codes.
- `country` (text): The country or region.
- `country_code` (text): Its ILOSTAT code.
- `found` (true/false): Whether ILOSTAT has a value for the country.
- `frequency` (text): The series read: annual, quarterly or monthly.
- `indicator` (text): The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
- `label` (text): What the indicator measures, e.g. Unemployment rate by sex and age (%).
- `notes` (text): ILOSTAT's notes on how it was measured.
- `period` (text): The year (2025), quarter (2026-Q2) or month (2026-09) of the value.
- `sex` (text): Total, Female or Male.
- `source` (text): The survey or estimate it comes from.
- `status` (text): ILOSTAT's flag on the value, if any.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `unit` (text): The unit values are in, e.g. %, hours, persons or local currency.
- `unit_multiplier` (text): thousands or millions when values are counted in them (Employment 31,000 in thousands is 31 million people). Empty when values are as they are.
- `url` (text): The indicator in ILOSTAT's data explorer.
- `value` (number): The latest value, in the indicator's unit.
- `year` (number): The year of the value.

**Example output**

```json
{
  "attribution": "Source: ILOSTAT, International Labour Organization (ILO). Licensed under CC BY 4.0.",
  "breakdown": "Age (Youth, adults): 15+",
  "breakdown_code": "AGE_YTHADULT_YGE15",
  "country": "France",
  "country_code": "FRA",
  "found": true,
  "frequency": "annual",
  "indicator": "UNE_DEAP_SEX_AGE_RT",
  "label": "Unemployment rate by sex and age (%)",
  "notes": "Repository: Eurostat special tabulation",
  "period": "2025",
  "sex": "Total",
  "source": "LFS - Employment Survey",
  "status": null,
  "summary": "Unemployment rate by sex and age (%) in France: 7.7% (2025).",
  "unit": "%",
  "unit_multiplier": null,
  "url": "https://rplumber.ilo.org/dataexplorer/?id=UNE_DEAP_SEX_AGE_RT_A&lang=en",
  "value": 7.7,
  "year": 2025
}
```

### Get an indicator

Get what an ILOSTAT indicator measures: its definition, unit, topic and database, each series it is published in (yearly, quarterly, monthly) with its years, countries and last update, and the breakdowns it has, such as sex and age.

**Inputs**

- Indicator (`indicator`, text, required): What to measure. Pick from the list (the headline figures come first) or type an ILOSTAT indicator id, such as one Search indicators found.

**Outputs**

- `breakdowns` (list): What its values are broken down by.
- `countries` (number): How many countries and regions have values.
- `database` (text): The ILOSTAT database it comes from.
- `definition` (text): What it measures, in ILOSTAT's words.
- `discontinued` (true/false): Whether ILOSTAT has stopped updating it.
- `frequencies` (list): Each series it is published in.
- `indicator` (text): The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
- `label` (text): What the indicator measures, e.g. Unemployment rate by sex and age (%).
- `last_updated` (text): When ILOSTAT last updated it.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `topic` (text): The topic ILOSTAT files it under.
- `unit` (text): The unit values are in, e.g. %, hours, persons or local currency.
- `unit_multiplier` (text): thousands or millions when values are counted in them (Employment 31,000 in thousands is 31 million people). Empty when values are as they are.
- `url` (text): The indicator in ILOSTAT's data explorer.

**Example output**

```json
{
  "breakdowns": [
    {
      "breakdown": "SEX",
      "groups": [],
      "name": "Sex",
      "value_count": 4
    },
    {
      "breakdown": "AGE",
      "groups": [
        "Youth and adults",
        "Aggregate age bands",
        "10-year age bands",
        "5-year age bands"
      ],
      "name": "Age",
      "value_count": 35
    }
  ],
  "countries": 306,
  "database": "Labour Force Statistics (LFS)",
  "definition": "With the aim of promoting international comparability, statistics presented on ILOSTAT are based on standard international definitions wherever feasible and may differ from official national figures. This series is based on the 13th ICLS definitions. For time series comparability, it includes countries that have implemented the 19th ICLS standards, for which data are also available in the Work Statistics -- 19th ICLS (WORK) database. The unemployment rate conveys the number of persons who are unemployed as a percent of the labour force (i.e., the employed plus the unemployed). The unemployed comprise all persons of working age who were: a) without work during the reference period, i.e. were not in paid employment or self-employment; b) currently available for work, i.e. were available for paid employment or self-employment during the reference period; and c) seeking work, i.e. had taken specific steps in a specified recent period to seek paid employment or self-employment. For more information, refer to the Labour Force Statistics (LFS and STLFS) database description.",
  "discontinued": false,
  "frequencies": [
    {
      "countries": 306,
      "dataset_id": "UNE_DEAP_SEX_AGE_RT_A",
      "first_year": 1947,
      "frequency": "annual",
      "last_updated": "2026-10-29",
      "last_year": 2027
    },
    {
      "countries": 123,
      "dataset_id": "UNE_DEAP_SEX_AGE_RT_Q",
      "first_year": 1948,
      "frequency": "quarterly",
      "last_updated": "2026-11-01",
      "last_year": 2026
    },
    {
      "countries": 86,
      "dataset_id": "UNE_DEAP_SEX_AGE_RT_M",
      "first_year": 1948,
      "frequency": "monthly",
      "last_updated": "2026-11-01",
      "last_year": 2026
    }
  ],
  "indicator": "UNE_DEAP_SEX_AGE_RT",
  "label": "Unemployment rate by sex and age (%)",
  "last_updated": "2026-11-01",
  "summary": "Unemployment rate by sex and age (%): annual, quarterly, monthly, 1947 to 2027, broken down by sex, age.",
  "topic": "Unemployment and labour underutilization",
  "unit": "%",
  "unit_multiplier": null,
  "url": "https://rplumber.ilo.org/dataexplorer/?id=UNE_DEAP_SEX_AGE_RT_A&lang=en"
}
```

### Get indicator data

Get one ILOSTAT indicator's values for some countries, or all of them, over a range of years: one row per country and period, newest first, with the source survey and ILOSTAT's notes. Totals unless a sex or breakdown is picked. Up to 10,000 rows.

**Inputs**

- Indicator (`indicator`, text, required): What to measure. Pick from the list (the headline figures come first) or type an ILOSTAT indicator id, such as one Search indicators found.
- Countries (`countries`, list): Which countries or regions to read. Empty for every one, which can be many rows.
- From year (`start_year`, number): The first year to include. Empty for the first. From 1900 to 2100.
- To year (`end_year`, number): The last year to include. Empty for the latest. From 1900 to 2100.
- Frequency (`frequency`, text): Yearly, quarterly or monthly figures. Empty for yearly, or the only series an indicator has. One of: `annual` (Yearly), `quarterly`, `monthly`.
- Sex (`sex`, text): Total, female or male, or all three. Ignored for an indicator with no sex breakdown. One of: `total`, `female`, `male`, `all` (Female, male and total). Default: `total`.
- Breakdown (`breakdown`, list): Values of the indicator's other breakdowns to read, such as an age band, an economic activity or a currency. Empty for each one's total; a breakdown with no total, such as currency, then gives every value.
- Every breakdown value (`every_breakdown`, true/false): On, every value of the breakdowns not picked in Breakdown is read (every age band, every activity), not only the totals. Default: `false`.
- Maximum rows (`limit`, number): The most rows to return: 1 to 10,000. 1,000 by default. From 1 to 10000. Default: `1000`.

**Outputs**

- `attribution` (text): The credit ILOSTAT's licence (CC BY 4.0) asks for wherever the figures are published.
- `breakdowns_used` (text): Which breakdown values were read, e.g. total age, or the values picked.
- `count` (number): How many rows are returned.
- `countries` (number): How many countries and regions have rows.
- `frequency` (text): The series read: annual, quarterly or monthly.
- `indicator` (text): The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
- `label` (text): What the indicator measures, e.g. Unemployment rate by sex and age (%).
- `missing` (list): Countries asked for that have no value.
- `rows` (list): The values, country by country, newest first.
- `sex` (text): The sex read: Total, Female, Male or all three.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total_rows` (number): How many rows ILOSTAT has for the request.
- `truncated` (true/false): Whether Maximum rows cut the rows short.
- `unit` (text): The unit values are in, e.g. %, hours, persons or local currency.
- `unit_multiplier` (text): thousands or millions when values are counted in them (Employment 31,000 in thousands is 31 million people). Empty when values are as they are.
- `url` (text): The indicator in ILOSTAT's data explorer.

**Example output**

```json
{
  "attribution": "Source: ILOSTAT, International Labour Organization (ILO). Licensed under CC BY 4.0.",
  "breakdowns_used": "total age",
  "count": 4,
  "countries": 2,
  "frequency": "annual",
  "indicator": "UNE_DEAP_SEX_AGE_RT",
  "label": "Unemployment rate by sex and age (%)",
  "missing": [],
  "rows": [
    {
      "breakdown": "Age (Youth, adults): 15+",
      "breakdown_code": "AGE_YTHADULT_YGE15",
      "country": "France",
      "country_code": "FRA",
      "notes": "Repository: ILO-STATISTICS - Micro data processing",
      "period": "2023",
      "sex": "Total",
      "source": "LFS - Employment Survey",
      "status": null,
      "value": 7.335,
      "year": 2023
    },
    {
      "breakdown": "Age (Youth, adults): 15+",
      "breakdown_code": "AGE_YTHADULT_YGE15",
      "country": "France",
      "country_code": "FRA",
      "notes": "Repository: ILO-STATISTICS - Micro data processing",
      "period": "2022",
      "sex": "Total",
      "source": "LFS - Employment Survey",
      "status": null,
      "value": 7.303,
      "year": 2022
    },
    {
      "breakdown": "Age (Youth, adults): 15+",
      "breakdown_code": "AGE_YTHADULT_YGE15",
      "country": "Germany",
      "country_code": "DEU",
      "notes": "Repository: ILO-STATISTICS - Micro data processing",
      "period": "2023",
      "sex": "Total",
      "source": "LFS - EU Labour Force Survey",
      "status": null,
      "value": 2.978,
      "year": 2023
    },
    {
      "breakdown": "Age (Youth, adults): 15+",
      "breakdown_code": "AGE_YTHADULT_YGE15",
      "country": "Germany",
      "country_code": "DEU",
      "notes": "Repository: ILO-STATISTICS - Micro data processing",
      "period": "2022",
      "sex": "Total",
      "source": "LFS - EU Labour Force Survey",
      "status": null,
      "value": 3.098,
      "year": 2022
    }
  ],
  "sex": "Total",
  "summary": "Got 4 values of Unemployment rate by sex and age (%) for 2 countries, 2022 to 2023.",
  "total_rows": 4,
  "truncated": false,
  "unit": "%",
  "unit_multiplier": null,
  "url": "https://rplumber.ilo.org/dataexplorer/?id=UNE_DEAP_SEX_AGE_RT_A&lang=en"
}
```

### List an indicator's breakdowns

List every value an ILOSTAT indicator can be broken down by besides sex, such as each age band, economic activity or currency, with the code to put in Breakdown and which value is the total used by default.

**Inputs**

- Indicator (`indicator`, text, required): What to measure. Pick from the list (the headline figures come first) or type an ILOSTAT indicator id, such as one Search indicators found.

**Outputs**

- `breakdowns` (list): What else it is broken down by, e.g. Age.
- `count` (number): How many values are listed.
- `has_sex` (true/false): Whether its values are also broken down by sex.
- `indicator` (text): The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
- `label` (text): What the indicator measures, e.g. Unemployment rate by sex and age (%).
- `summary` (text): One sentence saying what came back, for a message or a log.
- `values` (list): Every value, breakdown by breakdown.

**Example output**

```json
{
  "breakdowns": [
    "Age"
  ],
  "count": 3,
  "has_sex": true,
  "indicator": "UNE_DEAP_SEX_AGE_RT",
  "label": "Unemployment rate by sex and age (%)",
  "summary": "Unemployment rate by sex and age (%) is broken down by Age: 3 values.",
  "values": [
    {
      "breakdown": "AGE",
      "breakdown_name": "Age",
      "code": "AGE_YTHADULT_YGE15",
      "group": "Youth and adults",
      "is_total": true,
      "label": "Age (Youth and adults): 15+",
      "name": "15+"
    },
    {
      "breakdown": "AGE",
      "breakdown_name": "Age",
      "code": "AGE_YTHADULT_Y15-64",
      "group": "Youth and adults",
      "is_total": false,
      "label": "Age (Youth and adults): 15-64",
      "name": "15-64"
    },
    {
      "breakdown": "AGE",
      "breakdown_name": "Age",
      "code": "AGE_YTHADULT_Y15-24",
      "group": "Youth and adults",
      "is_total": false,
      "label": "Age (Youth and adults): 15-24",
      "name": "15-24"
    }
  ]
}
```

### List countries and regions

List the countries ILOSTAT has figures for, all or one ILO region or income group, with each one's code, region, income group, years covered and number of indicators, and optionally the regions and income groups it adds up, such as World.

**Inputs**

- Region (`region`, text): Only countries in this ILO region. One of: `africa`, `americas`, `arab_states` (Arab States), `asia_pacific` (Asia and the Pacific), `europe_central_asia` (Europe and Central Asia).
- Income group (`income_group`, text): Only countries in this World Bank income group. One of: `low` (Low income), `lower_middle` (Lower-middle income), `upper_middle` (Upper-middle income), `high` (High income).
- Include regions (`include_regions`, true/false): On, the regions and income groups ILOSTAT adds up (World is X01) are listed after the countries, when no Region or Income group is picked. Default: `false`.

**Outputs**

- `count` (number): How many are listed.
- `countries` (list): The countries by name, then any regions.
- `income_group` (text): The income group asked for.
- `region` (text): The ILO region asked for.
- `summary` (text): One sentence saying what came back, for a message or a log.

**Example output**

```json
{
  "count": 2,
  "countries": [
    {
      "code": "FRA",
      "first_year": 1955,
      "frequencies": [
        "annual",
        "quarterly",
        "monthly"
      ],
      "income_group": "High income",
      "indicator_count": 1009,
      "is_region": false,
      "last_year": 2030,
      "name": "France",
      "region": "Europe and Central Asia",
      "subregion": "Northern, Southern and Western Europe"
    },
    {
      "code": "DEU",
      "first_year": 1955,
      "frequencies": [
        "annual",
        "quarterly",
        "monthly"
      ],
      "income_group": "High income",
      "indicator_count": 809,
      "is_region": false,
      "last_year": 2030,
      "name": "Germany",
      "region": "Europe and Central Asia",
      "subregion": "Northern, Southern and Western Europe"
    }
  ],
  "income_group": "High income",
  "region": "Europe and Central Asia",
  "summary": "Listed 2 countries (Europe and Central Asia, High income)."
}
```

### Search indicators

Find ILOSTAT indicators by words in their names, topic and frequency, best match first, each with its id, unit, how often it is published, the years and number of countries it covers and what it is broken down by.

**Inputs**

- Search for (`keywords`, text): Words to look for in indicators' names, e.g. unemployment youth or monthly earnings. Empty lists the headline figures first.
- Topic (`topic`, text): Only indicators filed under this topic, e.g. Hours of work.
- Frequency (`frequency`, text): Only indicators published yearly, quarterly or monthly. One of: `annual` (Yearly), `quarterly`, `monthly`.
- Number of indicators (`limit`, number): How many to return, best match first: 1 to 100. 20 by default. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many indicators are returned.
- `frequency` (text): The frequency asked for.
- `indicators` (list): The indicators, best match first.
- `keywords` (text): The words searched for.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `topic` (text): The topic searched in.
- `total` (number): How many match in all.

**Example output**

```json
{
  "count": 2,
  "frequency": null,
  "indicators": [
    {
      "breakdowns": [
        "sex",
        "currency"
      ],
      "countries": 194,
      "database": "Wages and Working Time Statistics (COND)",
      "discontinued": false,
      "first_year": 1969,
      "frequencies": [
        "annual"
      ],
      "indicator": "EAR_EMTA_SEX_CUR_NB",
      "label": "Average monthly earnings of employees by sex and currency",
      "last_updated": "2026-10-26",
      "last_year": 2025,
      "topic": "Earnings and income",
      "unit": "currency",
      "unit_multiplier": null,
      "url": "https://rplumber.ilo.org/dataexplorer/?id=EAR_EMTA_SEX_CUR_NB_A&lang=en"
    },
    {
      "breakdowns": [],
      "countries": 175,
      "database": "Wages and Working Time Statistics (COND)",
      "discontinued": false,
      "first_year": 1980,
      "frequencies": [
        "annual"
      ],
      "indicator": "EAR_INEE_NOC_NB",
      "label": "Monthly minimum wage (local currency)",
      "last_updated": "2026-10-19",
      "last_year": 2026,
      "topic": "Earnings and income",
      "unit": "local currency",
      "unit_multiplier": null,
      "url": "https://rplumber.ilo.org/dataexplorer/?id=EAR_INEE_NOC_NB_A&lang=en"
    }
  ],
  "keywords": "wages",
  "summary": "Found 142 indicators for 'wages', showing 2.",
  "topic": null,
  "total": 142
}
```
