WORLDHUD

WorldHUD › Data API

Data API

The numbers WorldHUD shows, as plain files: 48 stats for 239 countries and territories, a leaderboard for each stat and the Level board, each value with its year, its source and its licence. Free, with no sign-up. Built from the data snapshot of 2026-11-15 by the same code as the app.

Open WorldHUD

What it is

The HUD's own numbers as files, under https://worldhud.io/api/v1/: JSON, CSV for the tables and GeoJSON for the places. Every stat value is the newest one its source published by the snapshot, with its own year; ranks, ties, "no recent data", per person, attributes and Levels are computed by the same rules as the app (Method & sources). The files change only when the snapshot does.

Quick start

curl -s https://worldhud.io/api/v1/places/SWE.json
curl -s https://worldhud.io/api/v1/boards/energy.elec_gen.csv
curl -s https://worldhud.io/api/v1/stats.json

The first lines of places/SWE.json, as built:

{
  "api": "v1",
  "generated": "2026-11-15",
  "docs": "https://worldhud.io/api/",
  "terms": "https://worldhud.io/api/#terms",
  "attribution": "Each value names its source and licence (source.name, source.url, source.licence): keep them with the value when you pass it on, as each licence requires. Share-alike material keeps its share-alike terms.",
  "data": {
    "place": {
      "iso3": "SWE",
      "iso2": "SE",
      "name": "Sweden",
      "slug": "sweden",
      "region": "Europe",
      "subregion": "Northern Europe",
      "player": true,
      "population": {
        "value": 10597000,
        "year": 2025,
        "source": {
          "name": "World Bank WDI",
          "agency": "UN (World Population Prospects); National statistical offices; Eurostat; UN (Population and Vital Statistics Report)",
          "url": "https://data.worldbank.org/indicator/SP.POP.TOTL",
          "licence": "CC BY 4.0",
          "retrieved": "2026-11-12"
        }
      },
      "links": {
        "sheet": "places/SWE.json",
        "page": "https://worldhud.io/country/sweden/",
        "app": "https://worldhud.io/#/country/SWE"
  …

Files

All under https://worldhud.io/api/v1/. {ISO3} is the place's three-letter code; {stat} is a stat id as stats.json names its file (the id in lower case, any character other than a letter, a digit, ".", "_" or "-" made "-"; energy.solar stays energy.solar).

PathWhatRows
index.jsonEvery file with its rows343 files
stats.jsonThe stats catalogue: unit, direction, newest year, places ranked, full provenance48
places.jsonEvery place: codes, name, slug, region, population, Level, rank, rank range, class, attributes, 10-year progress, badges239
places.csvThe same places, one flat row each239
places.geojsonThe globe's 177 shapes and 65 places with no shape as points, with Level, attributes and class242 features
places/{ISO3}.jsonOne place's sheet: every stat it reports at its newest value, with its rank, per person where there is one, and its source239 files
boards/{stat}.jsonOne board, in rank order, then the places with no recent data; "level" is the Level board49 files
boards/{stat}.csvThe same boards as CSV; every row names its year, source and licence49 files
openapi.jsonThis API described as OpenAPI 3.1

Fields

Attribution

When you pass a value on, pass on its source and licence with it. Each licence says what credit it needs; under CC BY, that is the source's name and a link to the licence. The sources and licences in this snapshot:

SourceLicenceFor
Our World in Data – CO₂CC BY 4.0 (third-party data keeps its original licence)CO₂ emissions, CO₂ per person
Our World in Data – EnergyCC BY 4.0 (third-party data keeps its original licence)Electricity generated, Electricity per person, Renewable electricity, Low-carbon electricity, Solar power, Wind power, Nuclear power, Hydro power, Oil production, Gas production, Coal production, Energy use per person, filled values of Population
Our World in Data – Life expectancy at birthCC BY 3.0 IGOfilled values of Life expectancy
Paris 2024 medal table (Wikipedia)CC BY-SA 4.0 (Wikipedia text; the medal counts are facts published by the IOC)Paris 2024 medals, Paris 2024 golds
World Bank WDICC BY 4.0Cereal production, Cereal yield, Farm, forest and fishing output, Farm output per worker, Arable land per person, Agricultural land, Agriculture share of GDP, Undernourishment, Life expectancy, Infant mortality, Health spending per person, GDP, GDP per person, GDP growth, Exports, Unemployment, Electricity access, Internet users, Mobile subscriptions, Air passengers, Safe drinking water, Forest cover, Protected land, Land area, R&D spending, University enrolment, Patent applications, High-tech exports, Population, Urban population, Population growth, Fertility rate

Share-alike. Paris 2024 medals and Paris 2024 golds: Paris 2024 medal table (Wikipedia), CC BY-SA 4.0 (Wikipedia text; the medal counts are facts published by the IOC). Whatever you make from these values must carry the same licence.

The shapes in places.geojson are from Natural Earth 1:110m (world-atlas): public domain. A place drawn as a point sits at the coordinates world.json records; each feature names their source.

Something missing?

If you need something these files do not have, such as a longer history, another format or another stat, write to hello@worldhud.io.

Not in the API

Terms

Draft of 2026-11-15.