Which indicators are included?

24 headline ones: GDP and GDP per capita, growth, population, life expectancy, fertility, infant mortality, internet and mobile penetration, unemployment, inflation, literacy, electricity access, health, education and military spending, Gini, net migration, FDI, forest cover and CO2 per capita, 230,449 values in total.

All 217 World Bank economies. Regional and income-group aggregates are excluded so rankings only compare real countries.

How far back does the data go?

To 1960 where the World Bank has values; coverage varies by indicator and country, and the latest year available is returned with each series.

Where does the data come from?

World Bank Open Data under CC BY 4.0. Attribution is published on the sources endpoint rather than repeated in every response.

How often is it refreshed?

The World Bank updates indicators on a rolling basis; the dataset is re-synced so new annual values appear after each release.

DataMAINTAINED1 token / call

Country Indicators API

24 World Bank development indicators for 217 countries since 1960: GDP, life expectancy, internet use and more

The world in numbers: 230,449 annual values for 24 headline development indicators across all 217 countries, from World Bank Open Data (CC-BY 4.0) back to 1960 and current through the latest releases. GDP and GDP per capita, growth, population, life expectancy, fertility and infant mortality, internet and mobile penetration, unemployment and inflation, literacy, electricity access, health/education/military spending, Gini inequality, net migration, FDI, forest cover and CO2 per capita. Rankings answer headline questions with current data — 2025 GDP: US $30.8T, China $19.5T, Germany, Japan, UK; life expectancy led by Monaco at 86.5; Slovakia the most equal society by Gini. Country profiles return the latest value of every indicator in one call (Japan: 123.4M people, 84.0 years, $35,951 GDP per capita); full time series come ready for charting; countries resolve by ISO2, ISO3 or plain name. Aggregates like "World" and "EU" are deliberately excluded so rankings contain only real countries. Built for dashboards, fintech and market-entry analysis, journalism, education and research. World Bank data (CC-BY), self-hosted — no third-party calls at request time.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 125+ APIsCancel anytime

response.json

{
  "ok": true,
  "indicator": {
    "slug": "gdp",
    "name": "GDP",
    "unit": "current US$"
  },
  "country": {
    "iso3": "USA",
    "name": "United States"
  },
  "count": 5,
  "values": [
    {
      "year": 2020,
      "value": 21375281000000
    },
    {
      "year": 2021,
      "value": 23725645000000
    },
    {
      "year": 2022,
      "value": 26054614000000
    },
    {
      "year": 2023,
      "value": 27811517000000
    },
    {
      "year": 2024,
      "value": 29298013000000
    }
  ]
}

Production Ready: Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration: Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs: Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Country Indicators API

Show a country profile card with GDP per capita, population, life expectancy and internet penetration.
Rank countries on any indicator for a given year, from CO2 per capita to Gini inequality.
Pull a time series back to 1960 for charts in research, journalism or classroom tools.
Score markets for expansion using growth, inflation, electricity access and mobile penetration together.

Country Indicators API endpoints

Every endpoint with its parameters and a real example response.

OpenAPI definition Postman workspace

GETCountry Profile
GETCountry Rankings
GETData Sources
GETIndicator Catalog
GETIndicator Series
GETList Countries

GETCountry Profile

https://api-country-indicators.dataandapis.com/v1/country/{code}

Path parameters

Parameter	Example
code	JP	Required

Example request

curl "https://api-country-indicators.dataandapis.com/v1/country/JP" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "country": {
    "iso3": "JPN",
    "iso2": "JP",
    "name": "Japan",
    "region": "East Asia & Pacific",
    "income_level": "High income",
    "capital": "Tokyo",
    "longitude": 139.77,
    "latitude": 35.67
  },
  "indicators": [
    {
      "indicator": "co2_per_capita",
      "name": "CO2 emissions per capita",
      "unit": "t CO2e",
      "year": 2024,
      "value": 7.8424
    },
    {
      "indicator": "education_expenditure_pct_gdp",
      "name": "Education expenditure",
      "unit": "% of GDP",
      "year": 2021,
      "value": 3.3366
    },
    {
…

Show full response

{
  "ok": true,
  "country": {
    "iso3": "JPN",
    "iso2": "JP",
    "name": "Japan",
    "region": "East Asia & Pacific",
    "income_level": "High income",
    "capital": "Tokyo",
    "longitude": 139.77,
    "latitude": 35.67
  },
  "indicators": [
    {
      "indicator": "co2_per_capita",
      "name": "CO2 emissions per capita",
      "unit": "t CO2e",
      "year": 2024,
      "value": 7.8424
    },
    {
      "indicator": "education_expenditure_pct_gdp",
      "name": "Education expenditure",
      "unit": "% of GDP",
      "year": 2021,
      "value": 3.3366
    },
    {
      "indicator": "electricity_access_pct",
      "name": "Access to electricity",
      "unit": "% of population",
      "year": 2024,
      "value": 100
    },
    {
      "indicator": "fdi_pct_gdp",
      "name": "Foreign direct investment inflows",
      "unit": "% of GDP",
      "year": 2025,
      "value": 1.0328
    },
    {
      "indicator": "fertility_rate",
      "name": "Fertility rate",
      "unit": "births per woman",
      "year": 2024,
      "value": 1.15
    },
    {
      "indicator": "forest_area_pct",
      "name": "Forest area",
      "unit": "% of land area",
      "year": 2023,
      "value": 68.3958
    },
    {
      "indicator": "gdp",
      "name": "GDP",
      "unit": "current US$",
      "year": 2025,
      "value": 4435162999976.94
    },
    {
      "indicator": "gdp_growth",
      "name": "GDP growth",
      "unit": "% annual",
      "year": 2025,
      "value": 1.1931
    },
    {
      "indicator": "gdp_per_capita",
      "name": "GDP per capita",
      "unit": "current US$",
      "year": 2025,
      "value": 35951.045
    },
    {
      "indicator": "gini",
      "name": "Gini index",
      "unit": "0-100",
      "year": 2020,
      "value": 32.3
    },
    {
      "indicator": "gni_per_capita",
      "name": "GNI per capita",
      "unit": "current US$",
      "year": 2025,
      "value": 38340
    },
    {
      "indicator": "health_expenditure_pct_gdp",
      "name": "Health expenditure",
      "unit": "% of GDP",
      "year": 2023,
      "value": 10.7398
    },
    {
      "indicator": "infant_mortality",
      "name": "Infant mortality",
      "unit": "per 1,000 live births",
      "year": 2024,
      "value": 1.8
    },
    {
      "indicator": "inflation_pct",
      "name": "Inflation (consumer prices)",
      "unit": "% annual",
      "year": 2025,
      "value": 3.1725
    },
    {
      "indicator": "internet_users_pct",
      "name": "Internet users",
      "unit": "% of population",
      "year": 2024,
      "value": 85.5415
    },
    {
      "indicator": "life_expectancy",
      "name": "Life expectancy at birth",
      "unit": "years",
      "year": 2024,
      "value": 84.0363
    },
    {
      "indicator": "military_expenditure_pct_gdp",
      "name": "Military expenditure",
      "unit": "% of GDP",
      "year": 2024,
      "value": 1.3714
    },
    {
      "indicator": "mobile_subscriptions",
      "name": "Mobile subscriptions",
      "unit": "per 100 people",
      "year": 2023,
      "value": 178.4324
    },
    {
      "indicator": "net_migration",
      "name": "Net migration",
      "unit": "people",
      "year": 2025,
      "value": 140579
    },
    {
      "indicator": "population",
      "name": "Population",
      "unit": "people",
      "year": 2025,
      "value": 123366734
    },
    {
      "indicator": "population_growth",
      "name": "Population growth",
      "unit": "% annual",
      "year": 2025,
      "value": -0.4921
    },
    {
      "indicator": "unemployment_pct",
      "name": "Unemployment",
      "unit": "% of labor force",
      "year": 2025,
      "value": 2.451
    },
    {
      "indicator": "urban_population_pct",
      "name": "Urban population",
      "unit": "% of total",
      "year": 2025,
      "value": 92.3001
    }
  ]
}

GETCountry Rankings

https://api-country-indicators.dataandapis.com/v1/rankings

Query parameters

Parameter	Example
indicator	gdp	Optional
limit	25	Optional
order	desc	Optional
year	2025	Optional

Example request

curl "https://api-country-indicators.dataandapis.com/v1/rankings?indicator=gdp&limit=25&order=desc&year=2025" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "indicator": {
    "slug": "gdp",
    "name": "GDP",
    "unit": "current US$"
  },
  "year": 2025,
  "order": "desc",
  "count": 25,
  "results": [
    {
      "rank": 1,
      "iso3": "USA",
      "name": "United States",
      "region": "North America",
      "value": 30769700000000
    },
    {
      "rank": 2,
      "iso3": "CHN",
      "name": "China",
      "region": "East Asia & Pacific",
      "value": 19498039388042.6
    },
    {
      "rank": 3,
      "iso3": "DEU",
…

Show full response

{
  "ok": true,
  "indicator": {
    "slug": "gdp",
    "name": "GDP",
    "unit": "current US$"
  },
  "year": 2025,
  "order": "desc",
  "count": 25,
  "results": [
    {
      "rank": 1,
      "iso3": "USA",
      "name": "United States",
      "region": "North America",
      "value": 30769700000000
    },
    {
      "rank": 2,
      "iso3": "CHN",
      "name": "China",
      "region": "East Asia & Pacific",
      "value": 19498039388042.6
    },
    {
      "rank": 3,
      "iso3": "DEU",
      "name": "Germany",
      "region": "Europe & Central Asia",
      "value": 5050922925047.05
    },
    {
      "rank": 4,
      "iso3": "JPN",
      "name": "Japan",
      "region": "East Asia & Pacific",
      "value": 4435162999976.94
    },
    {
      "rank": 5,
      "iso3": "GBR",
      "name": "United Kingdom",
      "region": "Europe & Central Asia",
      "value": 4002587541846.01
    }
  ]
}

GETData Sources

https://api-country-indicators.dataandapis.com/v1/sources

This endpoint takes no parameters.

Example request

curl "https://api-country-indicators.dataandapis.com/v1/sources" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "attribution": "Data: World Bank Open Data (CC-BY 4.0)",
  "count": 1,
  "sources": [
    {
      "slug": "world-bank",
      "name": "World Bank Open Data (World Development Indicators)",
      "publisher": "The World Bank",
      "licence": "CC-BY 4.0 - attribution required",
      "source_url": "https://data.worldbank.org/",
      "file_url": "https://api.worldbank.org/v2",
      "cadence": "periodic re-harvest (WB updates quarterly)",
      "record_count": 230449,
      "retrieved_at": "2026-09-06"
    }
  ]
}

GETIndicator Catalog

https://api-country-indicators.dataandapis.com/v1/indicators

This endpoint takes no parameters.

Example request

curl "https://api-country-indicators.dataandapis.com/v1/indicators" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "count": 24,
  "indicators": [
    {
      "code": "EN.GHG.CO2.PC.CE.AR5",
      "slug": "co2_per_capita",
      "name": "CO2 emissions per capita",
      "unit": "t CO2e"
    },
    {
      "code": "SE.XPD.TOTL.GD.ZS",
      "slug": "education_expenditure_pct_gdp",
      "name": "Education expenditure",
      "unit": "% of GDP"
    },
    {
      "code": "EG.ELC.ACCS.ZS",
      "slug": "electricity_access_pct",
      "name": "Access to electricity",
      "unit": "% of population"
    },
    {
      "code": "BX.KLT.DINV.WD.GD.ZS",
      "slug": "fdi_pct_gdp",
      "name": "Foreign direct investment inflows",
      "unit": "% of GDP"
    },
…

Show full response

{
  "ok": true,
  "count": 24,
  "indicators": [
    {
      "code": "EN.GHG.CO2.PC.CE.AR5",
      "slug": "co2_per_capita",
      "name": "CO2 emissions per capita",
      "unit": "t CO2e"
    },
    {
      "code": "SE.XPD.TOTL.GD.ZS",
      "slug": "education_expenditure_pct_gdp",
      "name": "Education expenditure",
      "unit": "% of GDP"
    },
    {
      "code": "EG.ELC.ACCS.ZS",
      "slug": "electricity_access_pct",
      "name": "Access to electricity",
      "unit": "% of population"
    },
    {
      "code": "BX.KLT.DINV.WD.GD.ZS",
      "slug": "fdi_pct_gdp",
      "name": "Foreign direct investment inflows",
      "unit": "% of GDP"
    },
    {
      "code": "SP.DYN.TFRT.IN",
      "slug": "fertility_rate",
      "name": "Fertility rate",
      "unit": "births per woman"
    },
    {
      "code": "AG.LND.FRST.ZS",
      "slug": "forest_area_pct",
      "name": "Forest area",
      "unit": "% of land area"
    }
  ]
}

GETIndicator Series

https://api-country-indicators.dataandapis.com/v1/data

Query parameters

Parameter	Example
country	USA	Required
from	2020	Optional
indicator	gdp	Required
to	2024	Optional

Example request

curl "https://api-country-indicators.dataandapis.com/v1/data?country=USA&from=2020&indicator=gdp&to=2024" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "indicator": {
    "slug": "gdp",
    "name": "GDP",
    "unit": "current US$"
  },
  "country": {
    "iso3": "USA",
    "name": "United States"
  },
  "count": 5,
  "values": [
    {
      "year": 2020,
      "value": 21375281000000
    },
    {
      "year": 2021,
      "value": 23725645000000
    },
    {
      "year": 2022,
      "value": 26054614000000
    },
    {
      "year": 2023,
      "value": 27811517000000
…

Show full response

{
  "ok": true,
  "indicator": {
    "slug": "gdp",
    "name": "GDP",
    "unit": "current US$"
  },
  "country": {
    "iso3": "USA",
    "name": "United States"
  },
  "count": 5,
  "values": [
    {
      "year": 2020,
      "value": 21375281000000
    },
    {
      "year": 2021,
      "value": 23725645000000
    },
    {
      "year": 2022,
      "value": 26054614000000
    },
    {
      "year": 2023,
      "value": 27811517000000
    },
    {
      "year": 2024,
      "value": 29298013000000
    }
  ]
}

GETList Countries

https://api-country-indicators.dataandapis.com/v1/countries

Query parameters

Parameter	Example
income		Optional
q	japan	Optional
region		Optional

Example request

curl "https://api-country-indicators.dataandapis.com/v1/countries?q=japan" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "count": 1,
  "countries": [
    {
      "iso3": "JPN",
      "iso2": "JP",
      "name": "Japan",
      "region": "East Asia & Pacific",
      "income_level": "High income",
      "capital": "Tokyo",
      "longitude": 139.77,
      "latitude": 35.67
    }
  ]
}

Where the data comes from

Source: World Bank Open Data, 24 indicators for 217 economies (CC BY 4.0).
Freshness: Re-synced after World Bank releases; latest available year returned per series.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

6endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 125+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  'https://api-country-indicators.dataandapis.com/v1/country/{code}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Country Indicators API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Path Parameters

code

Target:

Client:

import axios from 'axios';

const url = 'https://api-country-indicators.dataandapis.com/v1/country/{code}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});