World Bank Indicators Data

World Bank indicators API returns annual observations by country, indicator, and year from the public World Bank API. World Bank data scraper output can also search indicator metadata and preserve missing values when requested.

What it does

Choose country codes, indicator IDs, and an annual date range. mode: "search" searches indicator names, IDs, and source notes instead of returning observations. includeNulls keeps missing-value rows; otherwise those rows are omitted.

Input example

{
  "mode": "data",
  "countries": [
    "USA"
  ],
  "indicators": [
    "SP.POP.TOTL"
  ],
  "startYear": 2022,
  "endYear": 2022,
  "maxItems": 10
}

The example uses fields defined in the actor input schema. Other filters can be set in the Apify input form.

Output fields

Examples below come from the first record in sample_output.json; long strings and arrays are shown as excerpts. Other modes and error rows can have different fields.

Field	Type in sample	Example value
type	string	"datapoint"
countryCode	string	"USA"
countryId	string	"US"
countryName	string	"United States"
indicatorId	string	"SP.POP.TOTL"
indicatorName	string	"Population, total"
year	number	2022
value	number	333996304
unit	string	""
decimal	number	0
observationStatus	string	""
sourceId	string	"2"
lastUpdated	string	"2026-07-13"
sourceUrl	string	"https://api.worldbank.org/v2/country/USA/indicator/SP.POP.TOTL?format=json&source…
retrievedAt	string	"2026-10-05T12:44:25.062410+00:00"
errors	array	[]

Output example

A trimmed record copied from sample_output.json:

{
  "type": "datapoint",
  "countryCode": "USA",
  "countryId": "US",
  "countryName": "United States",
  "indicatorId": "SP.POP.TOTL",
  "indicatorName": "Population, total",
  "year": 2022,
  "value": 333996304,
  "unit": "",
  "decimal": 0,
  "observationStatus": "",
  "sourceId": "2",
  "lastUpdated": "2026-07-13",
  "sourceUrl": "https://api.worldbank.org/v2/country/USA/indicator/SP.POP.TOTL?format=json&source=2&date=2022",
  "retrievedAt": "2026-10-05T12:44:25.062410+00:00",
  "errors": []
}

FAQ

What limits the export? maxItems caps all rows, including missing values, search results, and errors. Data mode is annual, and pagination and concurrency are bounded by the input settings.

Do I need a key, proxy, or login? No. The actor uses public World Bank endpoints without authentication.

What is the pricing model? The proposed datapoint event costs $0.001 per block of up to 100 saved non-null observations, pooled across the run. Search, null, and error rows do not trigger that event. The owner must configure the event in Apify before publication.

How are rate limits handled? Timeouts, invalid JSON, HTTP 429, and server failures get at most four attempts with backoff. Numeric Retry-After is honored up to 30 seconds.

How current are the values? lastUpdated comes from the World Bank response and retrievedAt records the run. Recent values can be missing and historical values can be revised; no interpolation is performed.

Use with AI agents / MCP

After this actor is available to your account, configure it as an actor tool in the Apify MCP server, or start a run through the Apify API with the same input JSON. Give the agent the actor identifier and access through your Apify credentials. Read the completed run’s default dataset through the returned run or dataset reference, check error fields before using records, and keep source URLs with quoted data. Limit the input to the task the agent is answering.

Source and reuse notes

An empty unit may be source data. Read the indicator definition before interpreting a value. Aggregates should not be added to country totals. Follow the World Bank dataset terms and source-specific attribution restrictions.