🌐 World Bank Global Economic Indicators Scraper

Extract official macroeconomic datasets, national GDP, inflation (CPI), population growth, foreign direct investment (FDI), and unemployment statistics across 200+ countries directly from the World Bank Open Data API.

---

🥊 Why This Actor Beats the Competition

Feature	🌐 This World Bank Scraper	🐢 IMF / OECD Manual Portals	🐌 Complex Statistical Packages
Speed	1,000+ data points / min (Direct JSON)	Manual Excel spreadsheet downloads	Complex R / Stata script setups
Pricing	$1.20 / 1,000 data points (PPR)	High manual labor cost	Expensive data subscriptions
Coverage	200+ countries, 50+ years	Often regional only	Varies by provider
Platform Usage	FREE (Zero compute charges)	Local processing overhead	High monthly seat licenses
Automation	1-Click Webhooks & Datasets	Repetitive manual downloading	Complex cron scheduling

---

🛠️ Step-by-Step: How to Use

Method 1: Apify Console (No-Code UI)

1. Open the actor in the Apify Console.
2. Enter the Country ISO Code (e.g. USA, GBR, DEU, JPN, CHN, IND or WLD).
3. Enter the Indicator Code (e.g. NY.GDP.MKTP.CD for GDP, FP.CPI.TOTL.ZG for Inflation %, SP.POP.TOTL for Population).
4. Set Start Year and End Year (e.g. 2015 to 2023).
5. Click Start to run and export the data to JSON, CSV, or Excel.

Method 2: Python SDK

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {
    "country": "USA",
    "indicator": "NY.GDP.MKTP.CD",
    "startYear": "2018",
    "endYear": "2023"
}
run = client.actor("litezero/world-bank-economic-indicators-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["country"], item["year"], "GDP:", item["value"])

Method 3: Node.js SDK

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('litezero/world-bank-economic-indicators-scraper').call({
    country: 'DEU',
    indicator: 'FP.CPI.TOTL.ZG',
    startYear: '2015',
    endYear: '2023',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

---

📥 Popular Indicator Codes

• NY.GDP.MKTP.CD - GDP (current US$)
• NY.GDP.PCAP.CD - GDP per capita (current US$)
• FP.CPI.TOTL.ZG - Inflation, consumer prices (annual %)
• SP.POP.TOTL - Total Population
• SL.UEM.TOTL.ZS - Unemployment, total (% of total labor force)
• BX.KLT.DINV.CD.WD - Foreign direct investment, net inflows (BoP, current US$)

---

📤 Output Data Dictionary & Sample

{
  "country": "United States",
  "countryId": "US",
  "countryIso3": "USA",
  "indicatorName": "GDP (current US$)",
  "indicatorCode": "NY.GDP.MKTP.CD",
  "year": 2023,
  "value": 27811517000000,
  "unit": "",
  "decimal": 0,
  "scrapedAt": "2026-10-04T05:45:00.000Z"
}

---

💡 Top Use Cases

1. Macroeconomic Forecasting & Hedge Funds: Feed official sovereign indicators into algorithmic trading models and currency valuation engines.
2. Global Market Entry Consulting: Compare multi-year GDP growth, inflation trajectory, and demographic expansion across prospective expansion markets.
3. ESG & Sustainability Analytics: Track international carbon emission metrics, renewable energy adoption, and economic disparity indices.