# World Bank Indicators: Country Data Series | $1/1K (`one_dollar_store/world-bank-indicators`) Actor $1 per 1,000 results, platform usage included. World Bank development indicators by country and year from the official API: GDP, population, inflation, trade, poverty and more. Region and income group included. No key. - **URL**: https://apify.com/one_dollar_store/world-bank-indicators.md - **Developed by:** [One Dollar Store](https://apify.com/one_dollar_store) (community) - **Categories:** Other, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 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. 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 Indicators: country data series by year **$1 per 1,000 rows. Platform usage included. No rental, no minimum.** Pull development indicators from the official World Bank Indicators API: GDP, population, inflation, trade, poverty, life expectancy and the thousands of other series the World Bank publishes. Give one or more indicator codes, a list of countries (codes or names) or all of them, and a range of years. Each value comes back as one row with the country, its World Bank region and income group, the indicator, the year and the number. No API key and no account with the World Bank. [Open it in Apify Console](https://console.apify.com/actors/GFCjcofacTzdhXcRp/input) ### What it costs | Rows | This actor | |---|---| | 1,000 | $1.00 | | 10,000 | $10.00 | | 100,000 | $100.00 | Plus $0.001 per run. One flat price, platform usage included, so there is no separate compute or proxy bill. One row is one country, one indicator and one year. A run returns at most 10,000 rows. The latest population and inflation for every country is about 400 rows, about $0.40 a run. Refreshing five indicators for every country once a year, latest value only, is about 1,000 rows, so about $1.00 a year. ### Why use it - **Official numbers, no key.** The rows come straight from the World Bank Indicators API. Nothing to sign up for on the World Bank side. - **Codes or names.** Write `USA`, `US` or `United States`. The actor matches the World Bank country list and says in the log which entries it could not match. - **Region and income group on every row.** Each row carries the World Bank region and income level of the country, so you can group and filter without a second lookup. Aggregates such as World or Euro area are marked with `isAggregate`. - **Latest value in one switch.** Turn on `latestValueOnly` to get the most recent year that has a value for each country, which is what most dashboards need. - **Safe for scheduled jobs.** An unknown indicator code or a country that is not in the list ends cleanly, with the reason in the log and zero rows if nothing else matched. A typo in the input does not crash the run. ### Quick start 1. Open the actor, keep the example values, press **Start**. 2. Or paste this input, which returns GDP and population for four countries over six years (48 rows): ```json { "indicators": ["NY.GDP.MKTP.CD", "SP.POP.TOTL"], "countries": ["USA", "IND", "CHN", "BRA"], "yearFrom": 2019, "yearTo": 2024, "maxItems": 100 } ``` 3. Download the results as JSON, CSV or Excel, or read them through the API. For the latest population of every country, use `{ "indicators": ["SP.POP.TOTL"], "countries": ["all"], "latestValueOnly": true, "onlyCountries": true, "maxItems": 300 }`. ### Use it from code ```bash curl -X POST "https://api.apify.com/v2/acts/one_dollar_store~world-bank-indicators/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"indicators": ["NY.GDP.MKTP.CD"], "countries": ["USA", "IND"], "yearFrom": 2019, "yearTo": 2024, "maxItems": 100}' ``` ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("one_dollar_store/world-bank-indicators").call( run_input={"indicators": ["NY.GDP.MKTP.CD"], "countries": ["USA", "IND"], "yearFrom": 2019, "yearTo": 2024, "maxItems": 100} ) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["country"], item["year"], item["value"]) ``` ### Use it from an AI assistant Claude, ChatGPT, Cursor and other assistants can call this actor through Apify's MCP server. Add it with this server address: ``` https://mcp.apify.com?tools=one_dollar_store/world-bank-indicators ``` Then ask, for example: "Get GDP in current US dollars for India, China and Brazil from 2019 to 2024 from the World Bank." The assistant needs the indicator code (NY.GDP.MKTP.CD), so include it or ask the assistant to look it up. ### Switching from another World Bank scraper Indicators go in `indicators` as codes, one per line. Countries go in `countries` as codes or names, or `all`. The period is `yearFrom` and `yearTo`, or `latestValueOnly` for the newest value. The core output fields are `countryCode`, `country`, `indicatorCode`, `indicator`, `year` and `value`. One row is one country, one indicator and one year. ### Input | Field | Type | Default | What it does | |---|---|---|---| | `indicators` | list of text | none | World Bank indicator codes, one per line, for example `NY.GDP.MKTP.CD` (GDP in US dollars), `SP.POP.TOTL` (population), `FP.CPI.TOTL.ZG` (inflation) or `SI.POV.DDAY` (poverty rate). The code is in the address of each indicator page on data.worldbank.org. Needed. | | `countries` | list of text | all | Country codes (`USA`, `IND` or `US`, `IN`) or English names, one per line. Write `all`, or leave empty, for every country and every group such as World, Euro area or Low income. | | `yearFrom` | number | ten years up to the last year | First year to read. Data goes back to 1960. | | `yearTo` | number | last year | Last year to read. Recent years often have no value yet. | | `latestValueOnly` | true or false | false | Return only the most recent year that has a value, for each country and indicator. The year range is ignored. | | `skipEmpty` | true or false | true | Leave out country years where the World Bank has no value. Turn it off to see every year as a row. | | `onlyCountries` | true or false | false | Drop regions, income groups and other aggregates such as World or Euro area, so only real countries remain. Useful with all countries. | | `maxItems` | number | 100 | Most rows in the run. Minimum 10, maximum 10,000. | Rows are countries times indicators times years. Four countries, two indicators and six years is 48 rows. If the total is above `maxItems`, the run stops at the limit. ### Output fields | Field | Meaning | |---|---| | `countryCode`, `countryIso2` | World Bank three letter code (ISO 3166 alpha 3 for countries, its own codes for groups) and the two letter code. | | `country` | Country or group name. | | `region` | World Bank region. Left out for groups such as World. | | `incomeLevel` | World Bank income classification, for example Lower middle income. Left out for groups. | | `isAggregate` | True for regions, income groups and other aggregates such as World or Euro area. | | `indicatorCode`, `indicator` | The indicator code and its name. The name usually carries the unit, for example GDP (current US$). | | `year` | Year the value refers to. | | `value` | The value, as a number. | | `unit` | Unit note when the API gives one. Most indicators carry the unit in their name. | | `obsStatus` | Status flag from the API when present, for example an estimate marker. | | `decimals` | Number of decimals the World Bank shows for this indicator. | | `sourceUpdated` | Date the World Bank last updated that indicator's database. | | `url` | Indicator page on data.worldbank.org for this country. | Fields the World Bank leaves empty are left out of the row. ### Sample results Real rows from a test run on 20 October 2026: GDP and population for India, the United States and China. ```json [ {"countryCode": "IND", "countryIso2": "IN", "country": "India", "region": "South Asia", "incomeLevel": "Lower middle income", "isAggregate": false, "indicatorCode": "NY.GDP.MKTP.CD", "indicator": "GDP (current US$)", "year": 2024, "value": 3760813470500.86, "decimals": 0, "sourceUpdated": "2026-10-08", "url": "https://data.worldbank.org/indicator/NY.GDP.MKTP.CD?locations=IN"}, {"countryCode": "USA", "countryIso2": "US", "country": "United States", "region": "North America", "incomeLevel": "High income", "isAggregate": false, "indicatorCode": "NY.GDP.MKTP.CD", "indicator": "GDP (current US$)", "year": 2024, "value": 29298013000000, "decimals": 0, "sourceUpdated": "2026-10-08", "url": "https://data.worldbank.org/indicator/NY.GDP.MKTP.CD?locations=US"}, {"countryCode": "CHN", "countryIso2": "CN", "country": "China", "region": "East Asia & Pacific", "incomeLevel": "Upper middle income", "isAggregate": false, "indicatorCode": "SP.POP.TOTL", "indicator": "Population, total", "year": 2024, "value": 1408975000, "decimals": 0, "sourceUpdated": "2026-10-08", "url": "https://data.worldbank.org/indicator/SP.POP.TOTL?locations=CN"}, {"countryCode": "IND", "countryIso2": "IN", "country": "India", "region": "South Asia", "incomeLevel": "Lower middle income", "isAggregate": false, "indicatorCode": "SP.POP.TOTL", "indicator": "Population, total", "year": 2023, "value": 1438069596, "decimals": 0, "sourceUpdated": "2026-10-08", "url": "https://data.worldbank.org/indicator/SP.POP.TOTL?locations=IN"} ] ``` ### Limits - **10,000 rows per run.** For more, run again with fewer countries or a shorter range of years. - **Indicator codes only.** The actor does not search indicators by name. Find the code in the address of the indicator's page on data.worldbank.org. A code that does not exist gives no rows, and the log names it. - **Recent years are often empty.** The World Bank fills in the latest year late and for few countries. By default empty country years are left out. Use `latestValueOnly` to get the newest value that exists for each country. - **All countries can be slow.** For a few countries a run takes a few seconds. With `countries` set to `all` and `latestValueOnly` on, the World Bank API took about 14 seconds per request in our tests, and a run for two indicators took about 30 seconds. - **Rate limit.** We found no published request limit for this API. The actor sends one request at a time, at most five per second, with up to 40 countries in each request, and it tries a failed request up to three times with a pause between tries. - **Region and income group are the current ones.** They come from the World Bank's current country list, not from the year of the value. Aggregates have neither. - **Values are as published.** The World Bank revises its series. `sourceUpdated` shows when the indicator's database was last updated. - **Credit the World Bank.** The data is published under the Creative Commons Attribution 4.0 license. Use is free for commercial and noncommercial work, with credit to the World Bank. ### FAQ **How much does it cost to collect 10,000 rows?** $10, plus $0.001 for each run. **Do I pay for compute or proxy on top?** No. Platform usage is included in the $1 per 1,000 price. No proxy is used. **Do I need an API key or a World Bank account?** No. The actor reads the public World Bank Indicators API. **How do I find an indicator code?** Open the indicator's page on data.worldbank.org. The code is the last part of the address, for example NY.GDP.MKTP.CD for GDP in current US dollars. **How do I get one number per country, the newest one?** Set `latestValueOnly` to true, `countries` to `all` and `onlyCountries` to true. You get one row per country and indicator, with the year of that value. **How current is the data?** The actor reads the API at the moment you run it. How recent the numbers are depends on the indicator and the country, because the World Bank publishes most series with a delay of a year or more. **Is it legal?** The actor reads data that the World Bank publishes openly. World Bank Open Data is released under the Creative Commons Attribution 4.0 license, which allows use for commercial and noncommercial purposes with credit to the World Bank. The actor does not log in to anything. Follow the license and the law where you live. **Is this an official World Bank product?** No. It is an independent tool and is not affiliated with or endorsed by the World Bank. **Do I need an Apify account?** Yes. Actors run from an Apify account, and a free account is enough to start: it includes $5 of platform usage every month. You can [sign up here](https://www.apify.com?fpr=ymnoit). This is a referral link and it costs you nothing. **Is there a limit on the free plan?** Yes. A run started from a free plan account delivers the first 10 results, then ends with a message and a link to the plans. Any paid plan returns everything you ask for, up to your own limit. The price per result is the same on every plan. ### More from The One Dollar Store Every actor here costs $1 per 1,000 results, platform usage included. See the whole store: https://apify.com/one_dollar_store **Open data and statistics** - [Eurostat Scraper](https://apify.com/one_dollar_store/eurostat-statistics-scraper): EU statistics tables as rows. - [Socrata Open Data Search](https://apify.com/one_dollar_store/socrata-open-data-search): Datasets and rows from city and state portals. - [Internet Archive Scraper](https://apify.com/one_dollar_store/internet-archive-items-scraper): Books, media and web items from archive.org. - [Wikipedia Pageviews](https://apify.com/one_dollar_store/wikipedia-pageviews-stats): Daily and monthly views per article. - [GDELT Scraper](https://apify.com/one_dollar_store/gdelt-news-events-scraper): Worldwide news articles by theme and tone. ### Changelog - October 2026: first release. # Actor input Schema ## `indicators` (type: `array`): World Bank indicator codes, one per line, for example NY.GDP.MKTP.CD (GDP in US dollars), SP.POP.TOTL (population), FP.CPI.TOTL.ZG (inflation) or SI.POV.DDAY (poverty rate). The code is in the address of each indicator page on data.worldbank.org. ## `countries` (type: `array`): Country codes (USA, IND or US, IN) or English country names, one per line. Write all, or leave empty, for every country and every group such as World, Euro area or Low income. ## `yearFrom` (type: `integer`): First year to read. Data goes back to 1960. If you leave it empty, the actor reads the ten years up to the last year. ## `yearTo` (type: `integer`): Last year to read. Empty means last year. Recent years often have no value yet. ## `latestValueOnly` (type: `boolean`): Return only the most recent year that has a value, for each country and indicator. The year range is ignored. ## `skipEmpty` (type: `boolean`): Leave out country years where the World Bank has no value. Turn it off to see every year as a row. ## `onlyCountries` (type: `boolean`): Drop regions, income groups and other aggregates such as World or Euro area, so only real countries remain. Useful together with all countries. ## `maxItems` (type: `integer`): Stop after this many rows. Rows are countries times indicators times years. Minimum 10, maximum 10,000. ## Actor input object example ```json { "indicators": [ "NY.GDP.MKTP.CD", "SP.POP.TOTL" ], "countries": [ "USA", "IND", "CHN", "BRA" ], "yearFrom": 2019, "yearTo": 2024, "latestValueOnly": false, "skipEmpty": true, "onlyCountries": false, "maxItems": 100 } ``` # Actor output Schema ## `results` (type: `string`): No description ## `summary` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "indicators": [ "NY.GDP.MKTP.CD", "SP.POP.TOTL" ], "countries": [ "USA", "IND", "CHN", "BRA" ], "yearFrom": 2019, "yearTo": 2024, "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("one_dollar_store/world-bank-indicators").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "indicators": [ "NY.GDP.MKTP.CD", "SP.POP.TOTL", ], "countries": [ "USA", "IND", "CHN", "BRA", ], "yearFrom": 2019, "yearTo": 2024, "maxItems": 100, } # Run the Actor and wait for it to finish run = client.actor("one_dollar_store/world-bank-indicators").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "indicators": [ "NY.GDP.MKTP.CD", "SP.POP.TOTL" ], "countries": [ "USA", "IND", "CHN", "BRA" ], "yearFrom": 2019, "yearTo": 2024, "maxItems": 100 }' | apify call one_dollar_store/world-bank-indicators --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,one_dollar_store/world-bank-indicators" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/GFCjcofacTzdhXcRp/builds/NfzAsfJCo2yRjx7et/openapi.json