# World Bank Data Scraper (`anyxsolutions/world-bank-data-scraper`) Actor
Scrape World Bank Open Data: GDP, population, inflation, unemployment, CO2 and 1,500+ development indicators for every country, region and year since 1960, by indicator code, keyword or data.worldbank.org link, with region and income level. No API key, no login.
- **URL**: https://apify.com/anyxsolutions/world-bank-data-scraper.md
- **Developed by:** [Anyx Solutions](https://apify.com/anyxsolutions) (community)
- **Categories:** Developer tools, Business
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
## What's an Apify Actor?
An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.
For examples already wired to this Actor's own input schema, see the [API](#api) section below.
Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).
# README
## World Bank Data Scraper
**GDP, population, inflation, unemployment, CO2 and 1,500+ World Bank development indicators for every country and year, as clean JSON.**
World Bank Open Data is the reference source for comparing countries: national accounts, prices,
jobs, population, health, education, energy, climate and poverty, for 217 economies and dozens of
regions and income groups, many series going back to 1960. This Actor scrapes World Bank Open Data
by indicator code, by keyword search, or from a data.worldbank.org link, for the countries and
years you choose. Every row is one value: an indicator for a country in a year, with the country's
ISO3 and ISO2 codes, region and income level, the unit, the date the series was last updated, the
source database, and a link to the chart on data.worldbank.org. Paste a country page to get its 24
headline indicators in one go. There is no login, no API key and no proxy to configure. Built for
economists and analysts, market-entry and country-risk research, ESG and climate reporting,
dashboards and BI, journalism, and feeding clean macro data into models and AI pipelines.
### โก Quick start
```json
{
"startUrls": [
{
"url": "https://data.worldbank.org/indicator/NY.GDP.MKTP.CD?locations=US-CN&start=2000&end=2020"
}
],
"maxItems": 5
}
```
Or pick indicators and countries, latest value only:
```json
{
"indicators": ["NY.GDP.MKTP.CD", "SP.POP.TOTL", "FP.CPI.TOTL.ZG"],
"countries": ["US", "CN", "DE", "IN", "BR"],
"mostRecentValues": 1,
"skipEmptyValues": true
}
```
Or search indicators by name, for every country since 2010:
```json
{
"indicatorSearch": ["unemployment total"],
"maxIndicatorsPerSearch": 2,
"yearFrom": 2010,
"maxItems": 5000
}
```
### ๐งฉ Input
| Field | Type | Required | Default | Description |
| ------------------------ | ------- | -------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `startUrls` | array | no | โ | data.worldbank.org pages: an indicator page with its countries and years (`/indicator/NY.GDP.MKTP.CD?locations=US-CN&start=2000&end=2020`), or a country or region page (`/country/united-states`, `/region/east-asia-and-pacific`). |
| `indicators` | array | no | โ | World Bank indicator codes, one per line, such as `NY.GDP.MKTP.CD` or `SP.POP.TOTL`. See the popular codes below. |
| `indicatorSearch` | array | no | โ | Find indicators by name, one search per line, such as `unemployment total` or `renewable energy`. Every word must appear in the name; a code prefix such as `SL.UEM` also works. |
| `maxIndicatorsPerSearch` | integer | no | `5` | How many matching indicators each search returns, best matches first. |
| `countries` | array | no | โ | Countries, regions or groups by ISO2 or ISO3 code or by name: `US`, `CHN`, `Germany`, `WLD` (world), `EUU` (European Union), `EAS` (East Asia & Pacific), `HIC` (high income). Empty or `all` means every country. |
| `includeAggregates` | boolean | no | `false` | When every country is asked for, also return regional and income-group aggregates such as World or Sub-Saharan Africa. |
| `yearFrom` | integer | no | โ | Only values for this year or later. Leave empty to start in 1960. |
| `yearTo` | integer | no | โ | Only values for this year or earlier. Leave empty to end at the latest year. |
| `mostRecentValues` | integer | no | โ | Only the latest N years per country, such as `1` for a snapshot. Overrides `yearFrom` and `yearTo`. |
| `skipEmptyValues` | boolean | no | `false` | Leave out years without a value. With `mostRecentValues`, returns the latest N years that have one. |
| `maxItems` | integer | no | โ | Maximum rows per indicator code, search match or start URL. The input form starts at 5; leave it empty to get every row. |
| `proxyConfiguration` | object | no | `{ "useApifyProxy": false }` | Proxy settings. World Bank data needs no proxy. |
Add at least one start URL, indicator code, indicator search or country. `countries`, `yearFrom`,
`yearTo`, `mostRecentValues` and `skipEmptyValues` apply to indicator codes, searches and country
pages. An indicator page keeps the countries and years set in its address and uses the input's only
when it has none. With countries but no indicators, you get the 24 headline indicators of a
country page.
**Popular indicator codes.** `NY.GDP.MKTP.CD` GDP (current US$) ยท `NY.GDP.PCAP.CD` GDP per capita
(current US$) ยท `NY.GDP.MKTP.KD.ZG` GDP growth (annual %) ยท `SP.POP.TOTL` population ยท
`SP.POP.GROW` population growth ยท `FP.CPI.TOTL.ZG` inflation, consumer prices (annual %) ยท
`SL.UEM.TOTL.ZS` unemployment (% of labor force) ยท `SP.DYN.LE00.IN` life expectancy ยท
`EN.GHG.CO2.PC.CE.AR5` CO2 emissions per capita ยท `SI.POV.DDAY` extreme poverty (% at $3.00 a
day) ยท `GC.DOD.TOTL.GD.ZS` central government debt (% of GDP) ยท `BX.KLT.DINV.WD.GD.ZS` foreign
direct investment (% of GDP) ยท `IT.NET.USER.ZS` internet users (% of population) ยท
`EG.ELC.ACCS.ZS` access to electricity ยท `EG.ELC.RNWX.ZS` renewable electricity. Any indicator's
code is in its data.worldbank.org address.
### ๐ค Output
Each row is one value: one indicator for one country or aggregate in one year. Years the World Bank
has no value for come back with `value` set to `null` unless `skipEmptyValues` is on. Rows come
country by country, latest year first.
#### Fields
| Field | Type | Description |
| --------------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `indicatorId` | string | Indicator code, such as `NY.GDP.MKTP.CD`. |
| `indicatorName` | string | Indicator name, such as `GDP (current US$)`. |
| `countryCode` | string | ISO3 code of the country, or the World Bank code of an aggregate (`WLD`, `EUU`, `HIC`). |
| `countryIso2` | string | ISO2 code of the country, or the World Bank's two-character code of an aggregate (`1W`, `EU`, `XD`). |
| `countryName` | string | Country or aggregate name. |
| `region` | string | World Bank region, such as `East Asia & Pacific`. `null` for aggregates. |
| `incomeLevel` | string | World Bank income group, such as `Upper middle income`. `null` for aggregates. |
| `isAggregate` | boolean | `true` for regions, income groups and other aggregates such as World. |
| `year` | integer | Year of the value. |
| `date` | string | Period as the World Bank labels it: a year, or a quarter or month in some databases. |
| `value` | number | The value, or `null` when the World Bank has none for that year. |
| `unit` | string | Unit of measure, such as `current US$` or `% of total labor force`. `null` for plain counts. |
| `obsStatus` | string | Observation status flag, such as an estimate marker, when the World Bank sets one. |
| `decimal` | integer | Decimal places the World Bank displays the value with. |
| `lastUpdated` | string | Date the series was last updated, `YYYY-MM-DD`. |
| `sourceName` | string | Database the series comes from, such as `World Development Indicators`. |
| `url` | string | The indicator's chart for this country on data.worldbank.org. |
Example output
```json
[
{
"indicatorId": "NY.GDP.MKTP.CD",
"indicatorName": "GDP (current US$)",
"countryCode": "CHN",
"countryIso2": "CN",
"countryName": "China",
"region": "East Asia & Pacific",
"incomeLevel": "Upper middle income",
"isAggregate": false,
"year": 2023,
"date": "2023",
"value": 18270356654533.2,
"unit": "current US$",
"obsStatus": null,
"decimal": 0,
"lastUpdated": "2026-10-08",
"sourceName": "World Development Indicators",
"url": "https://data.worldbank.org/indicator/NY.GDP.MKTP.CD?locations=CN"
},
{
"indicatorId": "NY.GDP.MKTP.CD",
"indicatorName": "GDP (current US$)",
"countryCode": "USA",
"countryIso2": "US",
"countryName": "United States",
"region": "North America",
"incomeLevel": "High income",
"isAggregate": false,
"year": 2023,
"date": "2023",
"value": 27811517000000,
"unit": "current US$",
"obsStatus": null,
"decimal": 0,
"lastUpdated": "2026-10-08",
"sourceName": "World Development Indicators",
"url": "https://data.worldbank.org/indicator/NY.GDP.MKTP.CD?locations=US"
}
]
```