World Bank Country Indicators - GDP, Population, Inflation

Get country-by-year economic and social indicators (GDP, population, inflation, unemployment, life expectancy and thousands more) from the public World Bank Indicators API (v2). One row per country x indicator x year. No API key, no scraping.

Attribution and terms (please read)

Data: The World Bank: World Development Indicators (or the other World Bank dataset named in each row's sourceName), and the original data provider listed in sourceOrganization. Every row carries an attribution field in the World Bank's requested format (The World Bank: <dataset name>: <data source>) - keep it when you reuse the data.

World Bank data is published under CC BY 4.0 "unless indicated otherwise in the data or indicator metadata" (https://data.worldbank.org/summary-terms-of-use). That page also says: you must not claim or imply that The World Bank endorses your use of the data, and "Some datasets and indicators are provided by third parties, and may not be redistributed or reused without the consent of the original data provider, or may be subject to additional terms and conditions." This Actor only reshapes the data (one row per country, indicator and year); it is not affiliated with or endorsed by The World Bank.

Input

{
  "countries": ["KOR", "USA", "JP"],
  "indicators": ["NY.GDP.MKTP.CD", "SP.POP.TOTL", "unemployment total"],
  "yearFrom": 2014,
  "yearTo": 2023
}

Field	Meaning
countries	ISO 2/3-letter codes, World Bank names, or all. Regions and income groups (World, Euro area, ...) are refused with a reason unless includeAggregates is true.
indicators	Indicator codes (any World Bank dataset) or name searches (World Development Indicators). Max 20.
mrv	Most recent N years (default 5 when no year range is given). Cannot be combined with yearFrom/yearTo.
yearFrom, yearTo	Year range. Open-ended ranges start at 1960 / end at the current year.
includeAggregates	Default false.
maxResults	Row cap (default 1000, max 20000). Missing-value rows count toward it.

With no input the Actor returns GDP (current US$) for South Korea and the USA, most recent 5 years.

Searching by name

If an entry is not a code (a code looks like NY.GDP.MKTP.CD), the Actor searches the World Development Indicators names: every word must appear in the name. The best match is used, and a free indicatorResolution row lists the chosen indicator and the other candidates. If the choice is not the one you meant, run again with the indicator code.

Output (one row per country x indicator x year)

countryIso3, countryIso2, countryName, isAggregate, indicatorCode, indicatorName, year (period is the raw period string), value, valueStatus (ok / missing), unit, obsStatus, decimal, sourceName, sourceOrganization, lastUpdated (last update of the World Bank dataset), dataAsOf (time of this query), attribution, disclaimer.

• unit is what the API reports and is usually empty - the unit is normally part of indicatorName (for example "GDP (current US$)").
• A missing year is never turned into 0. Rows without a published value have value: null, valueStatus: "missing" and a reason, and are not charged.
• A country with no observations for an indicator in the period gets one free row saying so.
• Unknown countries, aggregates requested without includeAggregates, unknown indicator codes and name searches without a match are returned as free rows with a reason (recordType input or indicatorResolution).
• If the World Bank API cannot be reached, affected rows have found: null and an error; the Actor never reports "no data" for a failure. If the indicator metadata cannot be loaded, rows still carry the data and sectionErrors.indicatorMetadata.
• If output is cut by maxResults or your spending limit, a free summary row says so.

Pricing

Charged per datapoint with a value (event datapoint-record). Missing values, notes and errors are free. The Actor respects your maximum cost per run.

Notes

• The API publishes annual data with some indicators in other periods; period keeps the raw label and year is null for non-annual labels.
• Values are published as-is and are revised by the World Bank; compare lastUpdated with your own copy.
• Requests are paced and retried politely (at most 4 per second).