The unemployed are people of working age who are without work, are available for work, and have taken specific steps to find work. The uniform application of this definition results in estimates of unemployment rates that are more internationally comparable than estimates based on national definitions of unemployment.

This indicator is measured in numbers of unemployed people as a percentage of the labour force and it is seasonally adjusted. The labour force is defined as the total number of unemployed people plus those in employment. Data are based on labour force surveys (LFS).

For European Union countries where monthly LFS information is not available, the monthly unemployed figures are estimated by Eurostat.

The unemployment rate is a lagging indicator: it tends to rise only once a slowdown is under way, so its change matters more than its level. The Sahm rule, for example, flags a US recession when the three-month average rises 0.5 percentage points above its low of the previous twelve months. Levels differ between countries for structural reasons (labour market rules, participation), so compare a country with its own history or its estimated natural rate rather than with other countries.

See definition: https://data.oecd.org/unemp/unemployment-rate.htm

It is also possible to get the data from the Global Macro Database (GMDB) by setting the gmdb_source to True.

Both sources return the rate as a decimal fraction of the labour force (0.036 for 3.6%), so the two are directly interchangeable. Only the OECD source supports monthly and quarterly frequency; the GMDB is annual only, so a monthly or quarterly request uses the OECD unless gmdb_source=True is passed, in which case the period argument has no effect.

With period=”monthly” (unless gmdb_source=True is passed explicitly) the euro area and the countries Eurostat covers come from Eurostat and the United Kingdom from the Office for National Statistics, which publish weeks before the OECD republishes their figures, and Brazil from the IBGE (as the UK, the average of the three months ending in each month); every other country comes from the OECD. The United States is extended with the months the Bureau of Labor Statistics has published since, when both agree on the months they share. None of these need an API key. The UK figure is the average of the three months ending in each month, as the Labour Force Survey reports it.

Both sources return a decimal fraction (0.036 for 3.6%).

Also known as: jobless rate, labor market, unemployment level.

Unemployment Rates in Python or via the MCP

Install the Finance Toolkit with:

pip install financetoolkit -U

Then call get_unemployment_rate as shown below.

from financetoolkit import Economics

economics = Economics(start_date='2021-03-01', end_date='2023-01-01')

economics.get_unemployment_rate(
    countries=['Germany', 'United States', 'Japan'],
    gmdb_source=False,
    period='quarterly'
)

Or, after setting up the Finance Toolkit MCP, ask:

How did the unemployment rate in Germany, the United States and Japan develop each quarter from the first quarter of 2021 to the first quarter of 2023?

Which returns:

  Germany United States Japan
2021Q1 0.039 0.0623 0.0287
2021Q2 0.037 0.0593 0.029
2021Q3 0.0343 0.0507 0.0277
2021Q4 0.0337 0.0417 0.0273
2022Q1 0.0323 0.0387 0.027
2022Q2 0.031 0.0363 0.026
2022Q3 0.031 0.0353 0.0253
2022Q4 0.031 0.0357 0.0253
2023Q1 0.0303 0.0353 0.026

Parameters

get_unemployment_rate accepts the following parameters.

ParameterTypeDescriptionExample
countrieslist[str] | str | NoneThe countries to include in the data. Defaults to None.["United States", "Germany"]
periodstr | NoneWhether to return the monthly, quarterly or the annual data. Defaults to None, which is quarterly when the Economics class was initialized with quarterly=True and monthly otherwise."quarterly"
gmdb_sourcebool | NoneWhether to get the data from the Global Macro Database (GMDB).False
rollingintThe rolling window size to use for smoothing the data (simple moving average). Defaults to None.4
trailingintThe trailing window size to use for summing the data over trailing periods (e.g. a trailing-4-quarter sum). Defaults to None.4
growthboolWhether to return the growth data or the actual data. Defaults to False.True
lagintThe number of periods to lag the data by. Defaults to 1.4
standardizeboolWhether to standardize (Z-Score) the result. When combined with growth=True, standardizes the growth values instead of the raw values. Defaults to False.True
roundingint | NoneThe number of decimals to round the results to. Defaults to None.2
gmdb_forecastsboolWhether to include the years the Global Macro Database projects, from the IMF’s World Economic Outlook, up to five years ahead. Only applies to data from the Global Macro Database. Defaults to False, which ends a series with its last observation.True
Share