# World Bank Data Scraper (`parseforge/world-bank-scraper`) Actor Scrape global development indicators from the World Bank covering 200+ countries. Get GDP, population, poverty rates, education, health metrics, and trade data with region, income level, and capital city metadata. Filter by country and indicator. - **URL**: https://apify.com/parseforge/world-bank-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg) ## 🌍 World Bank Economic Data Scraper Whether you're an economist comparing GDP across countries, a development researcher tracking poverty indicators, or a business analyst studying global market trends, this tool makes it easy to collect structured economic data from the World Bank for every country in the world. > **The World Bank Scraper collects global economic indicators including GDP, population, inflation, unemployment, literacy rates, life expectancy, CO2 emissions, poverty data, and foreign investment figures. Filter by country, indicator, and get enriched country metadata.** ### ✨ What Does It Do - πŸ’° **GDP and economic data** - collect GDP per capita, total GDP, and other economic indicators for any country or all countries - πŸ‘₯ **Population and demographics** - extract population totals, life expectancy, and literacy rates across all nations - πŸ“ˆ **Economic indicators** - track inflation (CPI), unemployment rates, and poverty headcount ratios - 🌿 **Environmental data** - gather CO2 emissions per capita for climate and sustainability research - πŸ’Ό **Investment flows** - collect foreign direct investment data for international business analysis - πŸ—ΊοΈ **Country metadata** - each record is enriched with region, income level, capital city, and geographic coordinates - πŸ”§ **Custom indicators** - use any World Bank indicator code to collect specialized datasets ### πŸ”§ Input - **Indicator** - select from 10 popular indicators or enter a custom World Bank indicator code - **Max Items** - how many records to collect (free users get 10 items, paid users up to 1,000,000) - **Custom Indicator Code** - enter any World Bank indicator code when using the "Custom Indicator" option - **Country** - filter by country code (e.g., US, GB, CN) or leave as "all" for worldwide data ```json { "indicator": "NY.GDP.PCAP.CD", "country": "US", "maxItems": 50 } ```` ### πŸ“Š Output Each record includes the indicator value enriched with country metadata. Download as JSON, CSV, or Excel. | Field | Description | |-------|-------------| | 🏳️ countryId | Two-letter country code | | 🌍 countryName | Full country name | | πŸ”€ countryIso3 | Three-letter ISO country code | | πŸ—ΊοΈ region | World Bank region classification | | πŸ’° incomeLevel | Income level (High, Upper middle, Lower middle, Low) | | πŸ›οΈ capitalCity | Capital city name | | πŸ“ latitude | Country latitude coordinate | | πŸ“ longitude | Country longitude coordinate | | πŸ“Š indicator | Indicator code | | πŸ“‹ indicatorName | Full indicator name | | πŸ“… year | Data year | | πŸ”’ value | Indicator value for that country and year | | πŸ• scrapedAt | Timestamp when the data was collected | ```json { "countryId": "US", "countryName": "United States", "countryIso3": "USA", "region": "North America", "incomeLevel": "High income", "capitalCity": "Washington D.C.", "latitude": 38.8895, "longitude": -77.032, "indicator": "NY.GDP.PCAP.CD", "indicatorName": "GDP per capita (current US$)", "year": 2023, "value": 80034.576, "scrapedAt": "2026-04-09T12:00:00.000Z" } ``` ### πŸ’Ž Why Choose the World Bank Scraper? | Feature | Our Tool | Manual World Bank Website | |---------|----------|--------------------------| | Batch collection | βœ… Up to 1M records | ❌ Browse charts one at a time | | All countries | βœ… 200+ countries at once | ⚠️ Select one by one | | Country metadata | βœ… Region, income, coordinates | ❌ Separate lookups | | Custom indicators | βœ… Any indicator code | ⚠️ Complex navigation | | Structured output | βœ… JSON, CSV, Excel | ❌ Charts and PDFs | | Automated scheduling | βœ… Monthly/yearly updates | ❌ Manual visits | ### πŸ“‹ How to Use 1. **Sign Up** - [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. **Configure** - select the economic indicator, country, and how many records you want 3. **Run It** - click "Start" and get structured economic data in seconds No coding, no setup, no manual browsing required. ### 🎯 Business Use Cases - πŸ“ˆ **Investment firms** - compare GDP growth, inflation, and investment flows across countries for emerging market analysis - πŸŽ“ **Academic researchers** - gather time-series data on development indicators for cross-country economic studies - πŸ›οΈ **NGOs and development organizations** - track poverty rates, literacy, and life expectancy to measure program impact - 🌿 **Sustainability teams** - monitor CO2 emissions per capita across nations for ESG reporting and climate research - πŸ’Ό **Market expansion teams** - analyze population, income levels, and economic growth to identify new market opportunities - πŸ“Š **Journalists and data reporters** - build data-driven stories using global economic indicators from a trusted source ### πŸ”— Integrate World Bank Scraper with any app - [Make](https://docs.apify.com/platform/integrations/make) - Automate economic data collection workflows - [Zapier](https://docs.apify.com/platform/integrations/zapier) - Get alerts when new World Bank data is released - [Slack](https://docs.apify.com/platform/integrations/slack) - Get notified in your team channel - [Google Drive](https://docs.apify.com/platform/integrations/drive) - Export economic data to spreadsheets - [Webhooks](https://docs.apify.com/platform/integrations/webhooks) - Trigger actions when runs complete ### πŸ’‘ Recommended Actors Looking for more data collection tools? Check out these related actors: | Actor | Description | Link | |-------|-------------|------| | GSA eLibrary Scraper | Collect government contract data from GSA | [Link](https://apify.com/parseforge/gsa-elibrary-scraper) | | FINRA BrokerCheck Scraper | Look up broker and advisor registration data | [Link](https://apify.com/parseforge/finra-brokercheck-scraper) | | Pitchbook Investors Scraper | Collect investor profiles and data | [Link](https://apify.com/parseforge/pitchbook-investors-scraper) | | PR Newswire Scraper | Collect press releases and news | [Link](https://apify.com/parseforge/pr-newswire-scraper) | | Smart Apify Actor Scraper | Discover and analyze Apify marketplace actors | [Link](https://apify.com/parseforge/smart-apify-actor-scraper) | **Pro Tip:** πŸ’‘ Browse our complete collection of [data collection actors](https://apify.com/parseforge) to find the perfect tool for your needs. ### πŸ†˜ Need Help? - Visit the [Apify documentation](https://docs.apify.com) for platform guides - Contact us at [Tally contact form](https://tally.so/r/BzdKgA) ### ⚠️ Disclaimer > This Actor is an independent tool and is not affiliated with, endorsed by, or connected to the World Bank Group, the International Bank for Reconstruction and Development, or any international organization. It accesses only publicly available data. # Actor input Schema ## `indicator` (type: `string`): Select the World Bank economic indicator to scrape ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `customIndicator` (type: `string`): Enter a custom World Bank indicator code (only used when 'Custom Indicator' is selected above) ## `country` (type: `string`): Select a country or choose All Countries ## `customCountry` (type: `string`): Enter a custom ISO2 country code (only used when Country is set to Custom). Example: GH for Ghana. ## Actor input object example ```json { "indicator": "NY.GDP.PCAP.CD", "maxItems": 10, "country": "all" } ``` # Actor output Schema ## `overview` (type: `string`): Overview # 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 = { "indicator": "NY.GDP.PCAP.CD", "maxItems": 10, "country": "all" }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/world-bank-scraper").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 = { "indicator": "NY.GDP.PCAP.CD", "maxItems": 10, "country": "all", } # Run the Actor and wait for it to finish run = client.actor("parseforge/world-bank-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "indicator": "NY.GDP.PCAP.CD", "maxItems": 10, "country": "all" }' | apify call parseforge/world-bank-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/world-bank-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "World Bank Data Scraper", "description": "Scrape global development indicators from the World Bank covering 200+ countries. Get GDP, population, poverty rates, education, health metrics, and trade data with region, income level, and capital city metadata. Filter by country and indicator.", "version": "0.0", "x-build-id": "oGVxmmzdCR0IWhEcH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~world-bank-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-world-bank-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~world-bank-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-world-bank-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~world-bank-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-world-bank-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "indicator" ], "properties": { "indicator": { "title": "Indicator", "enum": [ "NY.GDP.PCAP.CD", "NY.GDP.MKTP.CD", "SP.POP.TOTL", "FP.CPI.TOTL.ZG", "SL.UEM.TOTL.ZS", "SE.ADT.LITR.ZS", "SP.DYN.LE00.IN", "EN.ATM.CO2E.PC", "SI.POV.NAHC", "BX.KLT.DINV.CD.WD", "custom" ], "type": "string", "description": "Select the World Bank economic indicator to scrape" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "customIndicator": { "title": "Custom Indicator Code", "type": "string", "description": "Enter a custom World Bank indicator code (only used when 'Custom Indicator' is selected above)" }, "country": { "title": "Country", "enum": [ "all", "US", "GB", "CN", "JP", "DE", "IN", "FR", "BR", "IT", "CA", "RU", "KR", "AU", "ES", "MX", "ID", "NL", "SA", "TR", "CH", "PL", "SE", "BE", "TH", "AR", "AT", "NO", "AE", "NG", "IL", "IE", "SG", "MY", "PH", "DK", "ZA", "CO", "EG", "CL", "FI", "PT", "CZ", "NZ", "RO", "VN", "GR", "PE", "PK", "KZ", "KE", "custom" ], "type": "string", "description": "Select a country or choose All Countries" }, "customCountry": { "title": "Custom Country Code", "type": "string", "description": "Enter a custom ISO2 country code (only used when Country is set to Custom). Example: GH for Ghana." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```