ILOSTAT

App · 7 actions

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.

Actions

ActionWhat it does
Compare countriesRank 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.
Get a country's latest valueGet 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.
Get an indicatorGet 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.
Get indicator dataGet 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.
List an indicator's breakdownsList 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.
List countries and regionsList 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.
Search indicatorsFind 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.

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

IndicatorindicatortextRequired
What to measure. Pick from the list (the headline figures come first) or type an ILOSTAT indicator id, such as one Search indicators found.
Yearyearnumber
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.
Countriescountrieslist
Which countries to compare. Empty for every country ILOSTAT has a value for.
Sexsextext
Total, female or male. Ignored for an indicator with no sex breakdown.One of: total, female, male. Default: total.
Breakdownbreakdownlist
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.
Orderordertext
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 regionsinclude_regionstrue/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 manylimitnumber
How many to list, from the top: 1 to 400. Empty for all.From 1 to 400.

Outputs

as_oftext
The year compared, or each one's latest year.
attributiontext
The credit ILOSTAT's licence (CC BY 4.0) asks for wherever the figures are published.
breakdowns_usedtext
Which breakdown values were compared.
countnumber
How many countries are listed.
countrieslist
The countries, ranked.
frequencytext
The series read: annual, quarterly or monthly.
indicatortext
The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
labeltext
What the indicator measures, e.g. Unemployment rate by sex and age (%).
leadertext
The country ranked first.
leader_valuenumber
Its value.
missinglist
Countries asked for that have no value.
ordertext
highest_first or lowest_first.
sextext
The sex compared: Total, Female or Male.
summarytext
One sentence saying what came back, for a message or a log.
totalnumber
How many countries have a value.
unittext
The unit values are in, e.g. %, hours, persons or local currency.
unit_multipliertext
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.
urltext
The indicator in ILOSTAT's data explorer.
yearnumber
The year compared. Empty for each one's latest.
Example output
{
  "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

IndicatorindicatortextRequired
What to measure. Pick from the list (the headline figures come first) or type an ILOSTAT indicator id, such as one Search indicators found.
CountrycountrytextRequired
The country or region. Pick from the list, or type a name or its three-letter code, such as KEN.
Frequencyfrequencytext
Yearly, quarterly or monthly figures. Empty for yearly, or the only series an indicator has.One of: annual (Yearly), quarterly, monthly.
Sexsextext
Total, female or male. Ignored for an indicator with no sex breakdown.One of: total, female, male. Default: total.
Breakdownbreakdownlist
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

attributiontext
The credit ILOSTAT's licence (CC BY 4.0) asks for wherever the figures are published.
breakdowntext
What else the value is for, e.g. an age band.
breakdown_codetext
The same as codes.
countrytext
The country or region.
country_codetext
Its ILOSTAT code.
foundtrue/false
Whether ILOSTAT has a value for the country.
frequencytext
The series read: annual, quarterly or monthly.
indicatortext
The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
labeltext
What the indicator measures, e.g. Unemployment rate by sex and age (%).
notestext
ILOSTAT's notes on how it was measured.
periodtext
The year (2025), quarter (2026-Q2) or month (2026-09) of the value.
sextext
Total, Female or Male.
sourcetext
The survey or estimate it comes from.
statustext
ILOSTAT's flag on the value, if any.
summarytext
One sentence saying what came back, for a message or a log.
unittext
The unit values are in, e.g. %, hours, persons or local currency.
unit_multipliertext
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.
urltext
The indicator in ILOSTAT's data explorer.
valuenumber
The latest value, in the indicator's unit.
yearnumber
The year of the value.
Example output
{
  "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

IndicatorindicatortextRequired
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

breakdownslist
What its values are broken down by.
countriesnumber
How many countries and regions have values.
databasetext
The ILOSTAT database it comes from.
definitiontext
What it measures, in ILOSTAT's words.
discontinuedtrue/false
Whether ILOSTAT has stopped updating it.
frequencieslist
Each series it is published in.
indicatortext
The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
labeltext
What the indicator measures, e.g. Unemployment rate by sex and age (%).
last_updatedtext
When ILOSTAT last updated it.
summarytext
One sentence saying what came back, for a message or a log.
topictext
The topic ILOSTAT files it under.
unittext
The unit values are in, e.g. %, hours, persons or local currency.
unit_multipliertext
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.
urltext
The indicator in ILOSTAT's data explorer.
Example output
{
  "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

IndicatorindicatortextRequired
What to measure. Pick from the list (the headline figures come first) or type an ILOSTAT indicator id, such as one Search indicators found.
Countriescountrieslist
Which countries or regions to read. Empty for every one, which can be many rows.
From yearstart_yearnumber
The first year to include. Empty for the first.From 1900 to 2100.
To yearend_yearnumber
The last year to include. Empty for the latest.From 1900 to 2100.
Frequencyfrequencytext
Yearly, quarterly or monthly figures. Empty for yearly, or the only series an indicator has.One of: annual (Yearly), quarterly, monthly.
Sexsextext
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.
Breakdownbreakdownlist
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 valueevery_breakdowntrue/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 rowslimitnumber
The most rows to return: 1 to 10,000. 1,000 by default.From 1 to 10000. Default: 1000.

Outputs

attributiontext
The credit ILOSTAT's licence (CC BY 4.0) asks for wherever the figures are published.
breakdowns_usedtext
Which breakdown values were read, e.g. total age, or the values picked.
countnumber
How many rows are returned.
countriesnumber
How many countries and regions have rows.
frequencytext
The series read: annual, quarterly or monthly.
indicatortext
The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
labeltext
What the indicator measures, e.g. Unemployment rate by sex and age (%).
missinglist
Countries asked for that have no value.
rowslist
The values, country by country, newest first.
sextext
The sex read: Total, Female, Male or all three.
summarytext
One sentence saying what came back, for a message or a log.
total_rowsnumber
How many rows ILOSTAT has for the request.
truncatedtrue/false
Whether Maximum rows cut the rows short.
unittext
The unit values are in, e.g. %, hours, persons or local currency.
unit_multipliertext
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.
urltext
The indicator in ILOSTAT's data explorer.
Example output
{
  "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

IndicatorindicatortextRequired
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

breakdownslist
What else it is broken down by, e.g. Age.
countnumber
How many values are listed.
has_sextrue/false
Whether its values are also broken down by sex.
indicatortext
The indicator's ILOSTAT id, e.g. UNE_DEAP_SEX_AGE_RT.
labeltext
What the indicator measures, e.g. Unemployment rate by sex and age (%).
summarytext
One sentence saying what came back, for a message or a log.
valueslist
Every value, breakdown by breakdown.
Example output
{
  "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

Regionregiontext
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 groupincome_grouptext
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 regionsinclude_regionstrue/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

countnumber
How many are listed.
countrieslist
The countries by name, then any regions.
income_grouptext
The income group asked for.
regiontext
The ILO region asked for.
summarytext
One sentence saying what came back, for a message or a log.
Example output
{
  "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 forkeywordstext
Words to look for in indicators' names, e.g. unemployment youth or monthly earnings. Empty lists the headline figures first.
Topictopictext
Only indicators filed under this topic, e.g. Hours of work.
Frequencyfrequencytext
Only indicators published yearly, quarterly or monthly.One of: annual (Yearly), quarterly, monthly.
Number of indicatorslimitnumber
How many to return, best match first: 1 to 100. 20 by default.From 1 to 100. Default: 20.

Outputs

countnumber
How many indicators are returned.
frequencytext
The frequency asked for.
indicatorslist
The indicators, best match first.
keywordstext
The words searched for.
summarytext
One sentence saying what came back, for a message or a log.
topictext
The topic searched in.
totalnumber
How many match in all.
Example output
{
  "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
}

On this page