Country Economic Snapshot — World Bank, One Flat Row

Market-research and expansion-planning teams pull country macro indicators one at a time from the World Bank's data portal, then reassemble them by hand. This returns one flat row per country — GDP, population, inflation, unemployment, internet penetration — with the latest available observation per indicator and the year that value is actually from. Free, keyless.

Input

{ "countries": ["US", "PK", "DE"] }

Two- or three-letter ISO codes both work. Leave indicators empty for all built-ins, or pass any raw World Bank indicator code (e.g. EN.ATM.CO2E.PC).

Built-in indicators

gdpUsd · gdpPerCapitaUsd · population · inflationPercent · unemploymentPercent · internetUsersPercent

Sample output

{
  "countryCode": "US",
  "countryName": "United States",
  "gdpUsdValue": 30769700000000,
  "gdpUsdYear": "2025",
  "populationValue": 341784857,
  "populationYear": "2025",
  "inflationPercentValue": 2.9495,
  "inflationPercentYear": "2024",
  "indicatorsRequested": 6,
  "indicatorsWithData": 6
}

Typical uses

• Market entry / expansion research — compare candidate countries on the same indicators in one table.
• Investment and risk screening — macro context for country exposure.
• Report and dashboard inputs — flat, spreadsheet-ready rows rather than nested time series.

Pricing

$0.002 per country snapshot.

⚠️ Read before you act — one real quirk, handled

• Every value carries its own year, on purpose. Different indicators publish on different schedules, so one country's GDP can be 2025 while its inflation figure is 2024. A single shared "as of" date would be wrong — hence <indicator>Value and <indicator>Year columns.
• The newest row from the World Bank is often empty. Verified live: US inflation returns 2025 → null (not published yet) before 2024 → 2.95. This actor scans for the most recent row that actually has a value, so a country isn't reported as "no data" when real data sits one row down. indicatorsWithData tells you how many genuinely resolved.
• An invalid country or indicator code returns no data, not an error row — check indicatorsWithData and the QUALITY_REPORT rather than assuming a null means "the value is zero."

FAQ

• Do I need an API key? No — the World Bank's API is free and keyless.
• Can I use indicators not in the built-in list? Yes — pass any World Bank indicator code directly in indicators.
• Why is one country's value older than another's? Reporting lag varies by country and indicator; the Year column makes that explicit rather than hiding it.

Related actors

• Currency & FX Rates — live and historical exchange rates, the companion to country-level macro data.
• Federal Award Intelligence — the same "official public data, aggregated into a usable row" approach, for US federal contracts.