World Bank Data Normalizer

Fetch, normalize, and export 1,600+ World Bank development indicators across 200+ countries — with human-readable labels, country names, and regional metadata. No API key required.

Raw World Bank API responses use cryptic indicator codes (NY.GDP.MKTP.CD) and ISO country codes (GBR). This Actor converts everything into clean, labeled records ready for analysis, dashboards, or AI pipelines.

Features

• 1,600+ indicators mapped to human-readable names (GDP, population, poverty, education, health, environment, etc.)
• 200+ countries and regions — ISO codes expanded to full names
• Regional classification — every record tagged with its World Bank region
• Flexible filtering — choose indicators, countries, year ranges
• Three output formats — Dataset (full data), OUTPUT (summary table), STATS (machine-readable)
• Free API — no authentication, no rate limits in normal use

Input Parameters

Parameter	Type	Required	Default	Description
indicatorCodes	string[]	Yes	—	World Bank indicator codes. See examples below.
countryCodes	string[]	No	All countries	ISO 3166-1 alpha-3 codes (e.g., USA, GBR, DEU)
yearRange	select	No	latest	latest, last5, last10, last20, all
maxResults	integer	No	500	Max data points to return (1–5000)

Example Input

{
  "indicatorCodes": ["NY.GDP.MKTP.CD", "SP.POP.TOTL", "SI.POV.GINI"],
  "countryCodes": ["USA", "GBR", "DEU", "JPN", "CHN", "IND"],
  "yearRange": "last5",
  "maxResults": 200
}

Example Output

{
  "countryCode": "GBR",
  "countryName": "United Kingdom",
  "region": "Europe & Central Asia",
  "indicatorCode": "NY.GDP.MKTP.CD",
  "indicatorName": "GDP (current US$)",
  "year": "2023",
  "value": 3340227800000,
  "unit": "",
  "decimal": 0,
  "obsStatus": ""
}

Commonly Used Indicators

Code	Description
NY.GDP.MKTP.CD	GDP (current US$)
NY.GDP.PCAP.CD	GDP per capita (current US$)
NY.GDP.MKTP.KD.ZG	GDP growth (annual %)
SP.POP.TOTL	Population, total
SP.DYN.LE00.IN	Life expectancy at birth (years)
SI.POV.GINI	Gini index
SI.POV.DDAY	Poverty headcount at $2.15/day
SE.ADT.LITR.ZS	Literacy rate, adult total (%)
IT.NET.USER.ZS	Individuals using the Internet (%)
SL.UEM.TOTL.ZS	Unemployment rate (%)
FP.CPI.TOTL.ZG	Inflation, consumer prices (annual %)
SH.XPD.CHEX.GD.ZS	Health expenditure (% of GDP)
EN.ATM.CO2E.PC	CO2 emissions (metric tons per capita)
SP.URB.TOTL.IN.ZS	Urban population (% of total)

Find more indicators at data.worldbank.org/indicator.

Use Cases

• Economic research — Compare GDP, inflation, trade across countries
• NGO reporting — Track poverty, education, health indicators for grant proposals
• Market analysis — Screen countries by population, internet penetration, GDP per capita
• AI/ML pipelines — Feed clean, labeled development data into models
• Dashboards — Power Tableau, Power BI, or custom analytics with structured data

Output Schema

Three outputs are produced:

1. Dataset — Complete normalized records (one per observation)
2. OUTPUT (Key-Value Store) — Human-readable summary table
3. STATS (Key-Value Store) — Machine-readable run statistics

Data Source

All data comes from the World Bank Data API, which is freely available under the Creative Commons Attribution 4.0 International License (CC BY 4.0). No API key or authentication is required.

---

Built with ❤️ by Chris The Dev