🌍 World Bank Data Normalizer

Fetch, normalize, and enrich World Bank development indicators — 29,500+ indicators across 295 countries and regions.

This Actor queries the World Bank API (free, no key required) and returns cleaned, normalized data with standardized country names, indicator short names, and formatted values. Perfect for economic research, market analysis, and data pipelines.

✨ What Makes This Different

Unlike raw API scrapers, this Actor normalizes and enriches the data:

• 🇺🇳 Country name normalization — "Russian Federation" → "Russia", "Korea, Rep." → "South Korea", "Iran, Islamic Rep." → "Iran"
• 📊 Indicator short names — "NY.GDP.MKTP.CD" → "GDP (current USD)"
• 🏷️ Aggregate filtering — Automatically skips regional/income aggregates (World, High income, etc.) when querying real countries
• 🔢 Smart value formatting — 1,234,567,890 → "1.23B"
• 📋 Metadata enrichment — Fetches indicator names, sources, and definitions from the World Bank API

📋 Input Parameters

Parameter	Type	Required	Description
indicators	Array	✅ Yes	World Bank indicator codes. See all 29,544 indicators
countries	Array	✅ Yes	ISO country codes (US, GB, CN) or "all" for every country
dateRange	String	No	Year range as start:end (e.g. 2020:2023). Empty = all available years
maxResults	Integer	No	Max data points per indicator (default: 500). 0 = unlimited
enrichMetadata	Boolean	No	Fetch indicator definitions from API (default: true)

🚀 Popular Indicator Codes

Code	Name
NY.GDP.MKTP.CD	GDP (current USD)
NY.GDP.MKTP.KD.ZG	GDP Growth (annual %)
NY.GDP.PCAP.CD	GDP per capita (current USD)
SP.POP.TOTL	Population, total
FP.CPI.TOTL.ZG	Inflation, CPI (annual %)
SL.UEM.TOTL.ZS	Unemployment (% of labor force)
BX.KLT.DINV.WD.GD.ZS	Foreign Direct Investment (% of GDP)
SI.POV.GINI	Gini Index
SP.DYN.LE00.IN	Life Expectancy (years)
IT.NET.USER.ZS	Internet Users (% of population)
SH.XPD.CHEX.GD.ZS	Health Expenditure (% of GDP)
EN.ATM.CO2E.KT	CO2 Emissions (kt)
SE.XPD.TOTL.GD.ZS	Education Expenditure (% of GDP)
GC.DOD.TOTL.GD.ZS	Government Debt (% of GDP)

📥 Example Input

{
  "indicators": ["NY.GDP.MKTP.CD", "SP.POP.TOTL", "FP.CPI.TOTL.ZG"],
  "countries": ["US", "GB", "CN", "DE", "JP", "IN", "BR"],
  "dateRange": "2020:2023",
  "maxResults": 500,
  "enrichMetadata": true
}

📤 Example Output (Dataset)

{
  "countryName": "United States",
  "countryCode": "USA",
  "indicatorCode": "NY.GDP.MKTP.CD",
  "indicatorName": "GDP (current USD)",
  "indicatorFullName": "GDP (current US$)",
  "year": 2023,
  "value": 27360900000000,
  "formattedValue": "27.36T"
}

🎯 Use Cases

• Economic Research — Compare GDP, inflation, unemployment across countries
• Market Analysis — Identify emerging markets by growth indicators
• Investment Research — Track FDI, trade balances, government debt
• Academic Work — Pull clean time series for papers and dissertations
• Dashboard Pipelines — Feed normalized World Bank data into BI tools
• AI/ML Training — Clean, structured development data for models

📊 Output

Key	Description
Dataset	All normalized data points (countryName, indicatorName, year, value, formattedValue)
OUTPUT	Human-readable summary table with top 50 rows
STATS	Machine-readable statistics (counts, year range, unique countries/indicators)

📚 Data Source

Data sourced from the World Bank API (free, no registration required). Licensed under Creative Commons Attribution 4.0 (CC-BY 4.0).