WorldJobsData Now Covers Economy and Human Development Data

What is now in every country record

The WorldJobsData API serves one JSON file per country at https://www.worldjobsdata.com/data/countries/{code}.json using a lowercase ISO alpha-2 code. Before this update, each record contained AI exposure scores per ISCO-08 occupation group and ILO workforce totals. It now includes two additional top-level objects.

Here is the structure of a country record after the update, trimmed to show the new fields:

{
  "country": "Germany",
  "code": "DE",
  "total_workers": 42800000,
  "isco_scores": [ ... ],
  "wb_economy": {
    "gdp_per_capita_usd": 60496,
    "gdp_per_capita_year": 2023,
    "population": 84482267,
    "population_year": 2023,
    "labor_force_participation_pct": 62.4,
    "labor_force_participation_female_pct": 56.8,
    "labor_force_participation_year": 2023,
    "unemployment_pct": 2.9,
    "unemployment_year": 2023,
    "poverty_headcount_3usd_pct": 0.2,
    "poverty_headcount_year": 2019,
    "gini": 31.7,
    "gini_year": 2019,
    "adult_literacy_pct": 99.0,
    "adult_literacy_year": 2018,
    "life_expectancy": 80.8,
    "life_expectancy_year": 2022
  },
  "hdr_data": {
    "hdi": 0.950,
    "hdi_rank": 7,
    "life_expectancy": 80.8,
    "expected_years_schooling": 17.0,
    "mean_years_schooling": 14.2,
    "gni_per_capita_ppp": 57810,
    "hdr_year": 2023
  }
}

Every numeric field includes a companion year field (for example gdp_per_capita_year) so you know exactly which survey or estimate year the value comes from. This matters: poverty and Gini data in particular can lag by several years for lower-income countries.

World Bank economy indicators

The wb_economy object contains 9 indicators sourced from the World Bank Open Data API (api.worldbank.org/v2/, CC BY 4.0). They were fetched via a Python script and baked into static JSON - there is no client-side World Bank dependency.

198 countries have at least partial World Bank data. The 8 countries without wb_economy records are territories or microstates where the World Bank does not publish estimates - for example, small island dependencies and special administrative regions that share statistics with a parent country.

UNDP Human Development Index

The hdr_data object comes from the UNDP Human Development Report Office (CC BY 3.0 IGO). 177 countries have HDR data. The 29 countries without it are primarily microstates and territories not included in the UNDP's HDI rankings.

The UNDP classifies countries into four HDI tiers: Very High (HDI 0.800 and above, 66 countries), High (0.700-0.799, 50 countries), Medium (0.550-0.699, 35 countries), and Low (below 0.550, 26 countries). Countries in the Very High and High tiers concentrate the bulk of cognitive, clerical, and professional work - the occupation groups with the highest AI exposure scores in the WorldJobsData dataset.

How to access the data

The API requires no key and no authentication. CORS is open, so a plain browser fetch() call works directly from any origin.

fetch('https://www.worldjobsdata.com/data/countries/de.json')
  .then(r => r.json())
  .then(data => {
    console.log(data.wb_economy.gdp_per_capita_usd); // 60496
    console.log(data.hdr_data.hdi);                  // 0.950
    console.log(data.hdr_data.hdi_rank);             // 7
  });

Country codes are lowercase ISO alpha-2: us.json, de.json, ng.json, in.json. An OpenAPI 3.1 specification documenting every field, type, and example value is available at /data/openapi.json. Full API documentation is at /api.

The data is static JSON served from Vercel's CDN. There are no rate limits, no pagination, and no server-side dependencies to manage. Each country file is self-contained - you can cache it locally, build on top of it, or include it in your own dataset.

How this data appears on the site

Both new data objects surface in two places on the live site.

Explore tool

The Explore tool now shows two additional cards when you select a country. Card 22 is the Economy at a Glance card, displaying GDP per capita, population, labour force participation, unemployment rate, and Gini coefficient from wb_economy. Card 23 is the Human Development Index card, showing the HDI score, global rank, education metrics, and GNI per capita from hdr_data. Both cards are visible for any country that has the relevant data and are omitted for the countries that do not.

Country pages

All 178 static country pages at /countries/ now include two new sections in the page body: Economy at a Glance and Human Development Index. These sections render from the same JSON data as the Explore tool, so the numbers are identical across both surfaces. The sections are part of the server-rendered initial HTML, which also helps Googlebot see them without depending on JavaScript execution.

Frequently asked questions