# World Bank Projects Scraper (`crawlerbros/world-bank-projects-scraper`) Actor Scrape World Bank Projects & Operations - 20,000+ development projects worldwide. Search by keyword, country, region, status, or sector. Fetch project details, funding amounts, objectives, and implementation data from the free World Bank API. - **URL**: https://apify.com/crawlerbros/world-bank-projects-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## World Bank Projects Scraper Scrape the [World Bank Projects & Operations](https://projects.worldbank.org/) database — 20,000+ development projects worldwide. Search by keyword, country, region, status, or sector. Fetch project details, funding amounts, development objectives, and implementation data from the free World Bank API. No authentication or proxy required. ### What this actor does - **Three modes:** `searchProjects`, `getProjectDetails`, `browseByCountry` - **Keyword search** across project names, objectives, and abstracts - **Filter by country, region, status, and lending sector** - **Look up specific projects** by their World Bank Project ID (e.g. `P505244`) - **Browse all projects** for a specific country code - **Full financial data:** total amount, IBRD/IDA commitments, lending project cost - **Project metadata:** approval date, closing date, fiscal year, borrower, implementing agency - **Empty fields are omitted** — no null pollution in your dataset ### Output per project | Field | Description | |---|---| | `projectId` | World Bank project ID (e.g. `P505244`) | | `projectName` | Full project title | | `status` | `Active`, `Closed`, or `Pipeline` | | `country` | Primary country name | | `countryCode` | ISO-2 country code (e.g. `RW`) | | `countries` | List of country names (multi-country projects) | | `countryCodes` | List of ISO-2 codes (multi-country projects) | | `region` | World Bank region name | | `approvalDate` | Board approval date (YYYY-MM-DD) | | `closingDate` | Project closing date (YYYY-MM-DD) | | `approvalFiscalYear` | Fiscal year of approval | | `totalAmount` | Total commitment in USD | | `lendingProjectCost` | Total project cost in USD | | `ibrdCommitment` | IBRD commitment in USD | | `idaCommitment` | IDA commitment in USD (when non-zero) | | `sector` | Lending instrument type | | `productLine` | Product line (e.g. `IBRD/IDA`) | | `financingTypes` | List of financing types (e.g. `["IBRD", "IDA"]`) | | `borrower` | Borrowing entity (government ministry, etc.) | | `implementingAgency` | Agency executing the project | | `teamLeader` | World Bank team leader name(s) | | `objective` | Project Development Objective (PDO) statement | | `abstract` | Detailed project description | | `projectUrl` | Direct link to project page on worldbank.org | | `recordType` | Always `"project"` | | `scrapedAt` | UTC ISO timestamp when the record was scraped | ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | select | `searchProjects` | Operating mode | | `query` | string | `climate change` | Keyword search (mode=searchProjects) | | `country` | select | – | ISO-2 country code filter | | `region` | select | – | World Bank region filter | | `status` | select | – | `Active`, `Closed`, or `Pipeline` | | `sector` | select | – | Lending instrument filter | | `projectIds` | array | – | Project IDs to fetch (mode=getProjectDetails) | | `maxItems` | integer | `50` | Max records to return (1–500) | #### Modes - **`searchProjects`** (default) — Search the World Bank project database using keywords and optional filters for country, region, status, and sector. Returns up to `maxItems` matching projects. - **`getProjectDetails`** — Fetch full details for one or more specific projects by their World Bank project ID (e.g. `P505244`). Supply a list in `projectIds`. - **`browseByCountry`** — Retrieve all projects associated with a specific country ISO-2 code (set in `country`). Useful for getting a complete portfolio of projects for a country. ### Example inputs #### Search active climate projects in South Asia ```json { "mode": "searchProjects", "query": "climate resilience", "region": "South Asia", "status": "Active", "maxItems": 100 } ```` #### Get specific projects by ID ```json { "mode": "getProjectDetails", "projectIds": ["P505244", "P180864", "P176429"] } ``` #### Browse all projects for India ```json { "mode": "browseByCountry", "country": "IN", "maxItems": 200 } ``` #### Search infrastructure projects in Africa ```json { "mode": "searchProjects", "query": "infrastructure road transport", "region": "Eastern and Southern Africa", "sector": "Investment Project Financing", "maxItems": 50 } ``` ### Use cases - **Development research** — Analyze World Bank project portfolios by country, region, or sector - **Policy analysis** — Track project approval trends, funding levels, and development objectives - **Country risk & finance** — Monitor active IBRD/IDA lending commitments per country - **Academic research** — Build datasets of development finance projects for statistical analysis - **NGO & consulting** — Identify World Bank projects in specific sectors or geographies - **Competitive intelligence** — Track development finance flows in target markets ### Data source Data is sourced from the [World Bank Projects API](https://search.worldbank.org/api/v2/projects) — a free, publicly accessible API with no authentication required. The API provides data on IBRD and IDA-financed projects across 180+ countries. ### FAQ **Do I need an API key or account?** No. The World Bank Projects API is completely free and open. No registration, API key, or proxy is required. **How many projects are available?** The database contains 20,000+ projects spanning decades of World Bank lending history. **What is the difference between `totalAmount` and `lendingProjectCost`?** `totalAmount` is the World Bank's total commitment (IBRD + IDA financing). `lendingProjectCost` is the total estimated project cost, which may be higher if there is co-financing from the government or other sources. **What country codes should I use?** Use ISO 3166-1 alpha-2 codes (e.g. `IN` for India, `BD` for Bangladesh, `NG` for Nigeria). The input field provides a dropdown with all supported country codes. **Can I get projects for multiple countries at once?** Use `mode=searchProjects` without a country filter, or run multiple `browseByCountry` requests with different country codes. **Why are some fields missing from certain records?** The World Bank API does not guarantee all fields are populated for every project. Empty fields are automatically omitted from the output to keep records clean. **How fresh is the data?** The World Bank Projects API is updated regularly. `scrapedAt` in each record shows when the data was retrieved. # Actor input Schema ## `mode` (type: `string`): What to fetch. `searchProjects` — search by keyword/filters; `getProjectDetails` — fetch specific projects by ID; `browseByCountry` — all projects for a country code. ## `query` (type: `string`): Free-text keyword search across project names, objectives, and abstracts (mode=searchProjects). ## `country` (type: `string`): Filter by country ISO2 code (mode=searchProjects). Also used as the target country in mode=browseByCountry. ## `region` (type: `string`): Filter by World Bank region name (mode=searchProjects). ## `status` (type: `string`): Filter by project status (mode=searchProjects). ## `sector` (type: `string`): Filter by lending instrument type (mode=searchProjects). ## `projectIds` (type: `array`): World Bank project IDs to fetch (e.g. `P505244`, `P180864`). Used in mode=getProjectDetails. ## `maxItems` (type: `integer`): Maximum number of project records to return (1–500). ## Actor input object example ```json { "mode": "searchProjects", "query": "climate change", "country": "", "region": "", "status": "", "sector": "", "projectIds": [], "maxItems": 50 } ``` # Actor output Schema ## `projects` (type: `string`): Dataset containing all scraped World Bank project records. # 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 = { "mode": "searchProjects", "query": "climate change", "country": "", "region": "", "status": "", "sector": "", "projectIds": [], "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/world-bank-projects-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 = { "mode": "searchProjects", "query": "climate change", "country": "", "region": "", "status": "", "sector": "", "projectIds": [], "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/world-bank-projects-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 '{ "mode": "searchProjects", "query": "climate change", "country": "", "region": "", "status": "", "sector": "", "projectIds": [], "maxItems": 50 }' | apify call crawlerbros/world-bank-projects-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/world-bank-projects-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "World Bank Projects Scraper", "description": "Scrape World Bank Projects & Operations - 20,000+ development projects worldwide. Search by keyword, country, region, status, or sector. Fetch project details, funding amounts, objectives, and implementation data from the free World Bank API.", "version": "1.0", "x-build-id": "g2VuB9hqFQmsXNlTB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~world-bank-projects-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-world-bank-projects-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/crawlerbros~world-bank-projects-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-world-bank-projects-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/crawlerbros~world-bank-projects-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-world-bank-projects-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "searchProjects", "getProjectDetails", "browseByCountry" ], "type": "string", "description": "What to fetch. `searchProjects` — search by keyword/filters; `getProjectDetails` — fetch specific projects by ID; `browseByCountry` — all projects for a country code.", "default": "searchProjects" }, "query": { "title": "Search keywords", "type": "string", "description": "Free-text keyword search across project names, objectives, and abstracts (mode=searchProjects).", "default": "climate change" }, "country": { "title": "Country", "enum": [ "", "AF", "AL", "DZ", "AO", "AR", "AM", "AZ", "BD", "BY", "BJ", "BO", "BA", "BW", "BR", "BF", "BI", "KH", "CM", "CF", "TD", "CL", "CN", "CO", "KM", "CD", "CG", "CR", "CI", "HR", "CU", "DJ", "DO", "EC", "EG", "SV", "GQ", "ER", "ET", "FJ", "GA", "GM", "GE", "GH", "GT", "GN", "GW", "GY", "HT", "HN", "IN", "ID", "IQ", "JM", "JO", "KZ", "KE", "KI", "KG", "LA", "LB", "LS", "LR", "LY", "MG", "MW", "MY", "MV", "ML", "MR", "MU", "MX", "MD", "MN", "MA", "MZ", "MM", "NA", "NP", "NI", "NE", "NG", "MK", "PK", "PA", "PG", "PY", "PE", "PH", "RO", "RW", "WS", "ST", "SN", "RS", "SL", "SO", "ZA", "SS", "LK", "SD", "SR", "SZ", "TJ", "TZ", "TH", "TL", "TG", "TO", "TT", "TN", "TR", "TM", "UG", "UA", "UZ", "VU", "VE", "VN", "YE", "ZM", "ZW" ], "type": "string", "description": "Filter by country ISO2 code (mode=searchProjects). Also used as the target country in mode=browseByCountry.", "default": "" }, "region": { "title": "Region", "enum": [ "", "Eastern and Southern Africa", "Western and Central Africa", "East Asia and Pacific", "Europe and Central Asia", "Latin America and Caribbean", "Middle East and North Africa", "South Asia", "Other" ], "type": "string", "description": "Filter by World Bank region name (mode=searchProjects).", "default": "" }, "status": { "title": "Project status", "enum": [ "", "Active", "Closed", "Pipeline" ], "type": "string", "description": "Filter by project status (mode=searchProjects).", "default": "" }, "sector": { "title": "Sector / lending instrument", "enum": [ "", "Investment Project Financing", "Development Policy Lending", "Program-for-Results Financing", "Recipient Executed Activities" ], "type": "string", "description": "Filter by lending instrument type (mode=searchProjects).", "default": "" }, "projectIds": { "title": "Project IDs (mode=getProjectDetails)", "type": "array", "description": "World Bank project IDs to fetch (e.g. `P505244`, `P180864`). Used in mode=getProjectDetails.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of project records to return (1–500).", "default": 50 } } }, "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 } } } } } } } } } } ```