# World Bank Projects Scraper (`maximedupre/world-bank-projects-scraper`) Actor Scrape World Bank Projects & Operations data by keyword, country, status, sector, year, or project ID. Export finance, sectors, borrowers, objectives, and World Bank Open Data indicators. - **URL**: https://apify.com/maximedupre/world-bank-projects-scraper.md - **Developed by:** [Maxime Duprรฉ](https://apify.com/maximedupre) (community) - **Categories:** Business, Education, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.01 / 1,000 saved project or indicators 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/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 database scraper World Bank Projects Scraper collects public World Bank Projects & Operations data and World Bank Open Data indicators. Use this world bank projects scraper to build project lists, country portfolios, funding dashboards, and spreadsheet exports without wiring your own World Bank API workflow. - [world bank projects database](https://apify.com/maximedupre/world-bank-projects-scraper/examples/search-world-bank-projects-database): Search public project data by topic, country, status, region, sector, approval year, or known project ID. - [world bank funded projects](https://apify.com/maximedupre/world-bank-projects-scraper/examples/export-world-bank-funded-projects): Export finance facts such as total commitment, IBRD, IDA, grant amount, product line, and lending instrument when World Bank provides them. - [world bank projects by country](https://apify.com/maximedupre/world-bank-projects-scraper/examples/scrape-world-bank-projects-by-country): Pull country portfolios with country codes such as `IN`, `BR`, `NG`, or `US`. - [world bank project list](https://apify.com/maximedupre/world-bank-projects-scraper/examples/create-world-bank-project-list): Create repeatable project lists for research, monitoring, CRM enrichment, or internal reporting. - [world bank projects in africa](https://apify.com/maximedupre/world-bank-projects-scraper/examples/scrape-world-bank-projects-in-africa): Filter by country or World Bank region to study regional development portfolios. - [world bank project examples](https://apify.com/maximedupre/world-bank-projects-scraper/examples/fetch-world-bank-project-examples): Fetch source-backed rows with objectives, abstracts, borrowers, implementing agencies, sectors, and themes. #### ๐Ÿ“ฆ Returned data Project rows are created for project search, country portfolio, and direct project ID runs. Fields can be `null` or empty when the World Bank source does not publish that value for a specific project. - Project identity: `projectId`, `projectName`, `status`, and `region` - Geography: `countries` with source country codes and names - Timeline: `approvalDate`, `closingDate`, and `approvalFiscalYear` - Finance: total commitment, IBRD, IDA, grant amount, project cost, product line, and lending instrument - Classification: `sectors`, `themes`, and `environmentalCategory` - Organizations and context: `borrower`, `implementingAgency`, `teamLead`, `objective`, and `abstract` Indicator rows are created when you use the indicator target section. Each row represents one country, indicator, and year, with `indicatorCode`, `indicatorName`, `country`, `year`, and `value`. #### ๐Ÿš€ How to run 1. Open the Input tab. 2. Fill one target section only: project search, project IDs, or indicator data. 3. For project search, start with the prefilled `climate resilience` and `energy` examples or add your own project topic. 4. Add country codes, status, region, sector, approval-year filters, or a known project ID when you have one. 5. For indicators, add World Bank indicator codes, country codes, and a year range. 6. Set the project or indicator row limit to control output size and cost. 7. Start the Actor and open the dataset. You can export results as JSON, CSV, Excel, XML, RSS, or HTML. You can also consume the same rows through the Apify API after the run finishes. #### โš™๏ธ Input Project search: ```json { "searchQueries": ["climate resilience", "energy"], "projectCountryCodes": ["IN", "BR"], "projectStatus": "Active", "approvalYearFrom": 2020, "approvalYearTo": 2026, "maxProjectRecords": 500 } ```` Project IDs: ```json { "projectIds": ["P505244", "P111669"] } ``` Indicator data: ```json { "indicatorCodes": ["NY.GDP.MKTP.CD", "SP.POP.TOTL"], "indicatorCountryCodes": ["US", "CN"], "indicatorYearFrom": 2020, "indicatorYearTo": 2023, "maxIndicatorRecords": 50 } ``` #### ๐Ÿงพ Output example Project row: ```json { "projectId": "P505244", "projectName": "Boosting Green Finance, Investment and Trade in Rwanda", "status": "Active", "region": "Eastern and Southern Africa", "countries": [ { "code": "RW", "name": "Republic of Rwanda" } ], "approvalDate": "2025-01-30", "closingDate": "2026-06-30", "approvalFiscalYear": 2025, "finance": { "totalCommitmentUsd": 200000000, "ibrdCommitmentUsd": 200000000, "idaCommitmentUsd": 0, "grantAmountUsd": null, "lendingProjectCostUsd": 0, "productLine": "PE", "lendingInstrument": "Development Policy Lending" }, "sectors": [], "themes": [], "environmentalCategory": null, "borrower": null, "implementingAgency": null, "teamLead": null, "objective": null, "abstract": null, "indicatorCode": null, "indicatorName": null, "country": null, "year": null, "value": null } ``` Indicator row: ```json { "projectId": null, "projectName": null, "status": null, "region": null, "countries": null, "approvalDate": null, "closingDate": null, "approvalFiscalYear": null, "finance": null, "sectors": null, "themes": null, "environmentalCategory": null, "borrower": null, "implementingAgency": null, "teamLead": null, "objective": null, "abstract": null, "indicatorCode": "NY.GDP.MKTP.CD", "indicatorName": "GDP (current US$)", "country": { "code": "US", "name": "United States" }, "year": 2023, "value": 27292170793214 } ``` #### ๐Ÿ’ณ Pricing This Actor uses pay-per-event pricing. You are charged `$0.00001` for each saved World Bank project or indicator item, which is `$0.01 per 1,000` saved items. There is no Actor-start charge. Empty searches, invalid mixed-target inputs, failed source requests, and no-result runs do not create paid output items. #### ๐Ÿ”Œ Integrations https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4 - Call the Actor from the Apify API to refresh World Bank project lists from your app or data pipeline. - Schedule runs to monitor new projects for selected countries, sectors, or topics. - Export CSV or Excel files for analysts who work in spreadsheets. - Send finished dataset links to webhooks, BI tools, databases, or internal review workflows. #### โ“ FAQ ##### ๐ŸŒ Can I scrape World Bank projects by country? Yes. Add one or more project country codes and leave the search query empty for a country portfolio run. You can also combine country codes with status, region, sector, and approval-year filters. ##### ๐Ÿ†” Can I fetch known World Bank project IDs? Yes. Use the Project IDs section and add IDs such as `P505244` or `P111669`. This is the fastest option when you already know the projects you want. ##### ๐Ÿ“Š Does it include World Bank indicators? Yes. Use the Indicator data section with indicator codes such as `NY.GDP.MKTP.CD` or `SP.POP.TOTL`, country codes such as `US` or `CN`, and a year range. ##### ๐Ÿ“„ Does it scrape World Bank procurement notices or tenders? No. This Actor returns project and indicator data. Use it for project context before procurement research, but procurement notices, tender documents, and bid attachments are separate source surfaces. ##### ๐Ÿ” Do I need a World Bank account or API key? No. The Actor uses public World Bank data. You do not need to provide a World Bank login, cookies, API key, or proxy. ##### ๐Ÿง  Does it summarize or rank projects? No. The Actor returns source-backed World Bank fields. It does not generate summaries, scores, recommendations, rankings, legal advice, or financial advice. ##### ๐Ÿงฉ Why not use the World Bank API? The World Bank API is public and useful. This Actor is for users who want Apify input forms, row limits, dataset exports, schedules, webhooks, and API access without building their own pagination, normalization, and output workflow. ##### ๐Ÿ”Ž What are World Bank alternatives? For related work, use the official World Bank Projects & Operations site, World Bank Open Data, World Bank procurement notices, regional development bank sites, government tender portals, or commercial aid and development-finance databases. ### ๐Ÿ“ Changelog - 0.1: Initial release. ### ๐Ÿ†˜ Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~world-bank-projects-scraper/issues) and I'll fix or implement it in less than 24h ๐Ÿซก ### ๐Ÿ”— Other actors - [EU Funding & Tenders Scraper โ†—](https://apify.com/maximedupre/eu-funding-tenders-scraper) - Export EU grant and tender opportunities with deadlines, budgets, programmes, and CPV data. - [Morningstar Scraper โ†—](https://apify.com/maximedupre/morningstar-scraper) - Export public stock, mutual fund, and ETF data for finance research. - [GLEIF LEI Lookup โ†—](https://apify.com/maximedupre/gleif-lei-lookup) - Look up legal entities, LEI codes, addresses, parent relationships, and KYB fields. - [Pappers Sirene Scraper โ†—](https://apify.com/maximedupre/pappers-sirene-scraper) - Search and enrich official French company registry data. - [Harris County Court Records Scraper โ†—](https://apify.com/maximedupre/harris-county-court-records-scraper) - Export public probate and civil court case records with parties, attorneys, and filing events. **Made with โค๏ธ by Maxime Duprรฉ** # Actor input Schema ## `searchQueries` (type: `array`): Search project names, objectives, and abstracts. Use country codes alone to collect country portfolios. ## `projectCountryCodes` (type: `array`): Filter projects by ISO 2-letter country codes. ## `projectRegion` (type: `string`): Filter projects by World Bank region. ## `projectStatus` (type: `string`): Filter projects by lifecycle status. ## `projectSector` (type: `string`): Filter by World Bank major sector, such as Education. ## `approvalYearFrom` (type: `integer`): Include projects approved from this year onward. ## `approvalYearTo` (type: `integer`): Include projects approved up to this year. ## `maxProjectRecords` (type: `integer`): Cap project rows for search and country portfolio runs. ## `projectIds` (type: `array`): Fetch specific World Bank project IDs. ## `indicatorCodes` (type: `array`): Collect World Bank Open Data indicators by code, such as NY.GDP.MKTP.CD. ## `indicatorCountryCodes` (type: `array`): Filter indicator rows by ISO 2-letter country codes, such as US or CN. ## `indicatorYearFrom` (type: `integer`): Include indicator values from this year onward. ## `indicatorYearTo` (type: `integer`): Include indicator values up to this year. ## `maxIndicatorRecords` (type: `integer`): Cap indicator rows across selected indicators, countries, and years. ## Actor input object example ```json { "searchQueries": [ "climate resilience", "energy" ], "projectCountryCodes": [ "IN", "BR" ], "projectRegion": "", "projectStatus": "", "maxProjectRecords": 500, "projectIds": [], "indicatorCodes": [], "indicatorCountryCodes": [], "maxIndicatorRecords": 50 } ``` # Actor output Schema ## `results` (type: `string`): Open the dataset with one row per saved World Bank project or indicator value. # 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 = { "searchQueries": [ "climate resilience", "energy" ], "projectCountryCodes": [ "IN", "BR" ], "projectRegion": "", "projectStatus": "", "projectSector": "", "maxProjectRecords": 500, "projectIds": [], "indicatorCodes": [], "indicatorCountryCodes": [], "maxIndicatorRecords": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/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 = { "searchQueries": [ "climate resilience", "energy", ], "projectCountryCodes": [ "IN", "BR", ], "projectRegion": "", "projectStatus": "", "projectSector": "", "maxProjectRecords": 500, "projectIds": [], "indicatorCodes": [], "indicatorCountryCodes": [], "maxIndicatorRecords": 50, } # Run the Actor and wait for it to finish run = client.actor("maximedupre/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 '{ "searchQueries": [ "climate resilience", "energy" ], "projectCountryCodes": [ "IN", "BR" ], "projectRegion": "", "projectStatus": "", "projectSector": "", "maxProjectRecords": 500, "projectIds": [], "indicatorCodes": [], "indicatorCountryCodes": [], "maxIndicatorRecords": 50 }' | apify call maximedupre/world-bank-projects-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/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 data by keyword, country, status, sector, year, or project ID. Export finance, sectors, borrowers, objectives, and World Bank Open Data indicators.", "version": "0.1", "x-build-id": "IJNgM76ct7O13WKIc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~world-bank-projects-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-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/maximedupre~world-bank-projects-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-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/maximedupre~world-bank-projects-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-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", "properties": { "searchQueries": { "title": "Project search queries", "type": "array", "description": "Search project names, objectives, and abstracts. Use country codes alone to collect country portfolios.", "items": { "type": "string", "minLength": 1 } }, "projectCountryCodes": { "title": "Project country codes", "type": "array", "description": "Filter projects by ISO 2-letter country codes.", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "projectRegion": { "title": "Project region", "enum": [ "", "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 projects by World Bank region.", "default": "" }, "projectStatus": { "title": "Project status", "enum": [ "", "Active", "Closed", "Pipeline", "Dropped" ], "type": "string", "description": "Filter projects by lifecycle status.", "default": "" }, "projectSector": { "title": "Project sector", "type": "string", "description": "Filter by World Bank major sector, such as Education." }, "approvalYearFrom": { "title": "Approval year from", "minimum": 1947, "maximum": 2030, "type": "integer", "description": "Include projects approved from this year onward." }, "approvalYearTo": { "title": "Approval year to", "minimum": 1947, "maximum": 2030, "type": "integer", "description": "Include projects approved up to this year." }, "maxProjectRecords": { "title": "Maximum project records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap project rows for search and country portfolio runs.", "default": 500 }, "projectIds": { "title": "Project IDs", "type": "array", "description": "Fetch specific World Bank project IDs.", "items": { "type": "string", "minLength": 2 } }, "indicatorCodes": { "title": "Indicator codes", "type": "array", "description": "Collect World Bank Open Data indicators by code, such as NY.GDP.MKTP.CD.", "items": { "type": "string", "minLength": 1 } }, "indicatorCountryCodes": { "title": "Indicator country codes", "type": "array", "description": "Filter indicator rows by ISO 2-letter country codes, such as US or CN.", "items": { "type": "string", "minLength": 2, "maxLength": 2 } }, "indicatorYearFrom": { "title": "Indicator year from", "minimum": 1960, "maximum": 2030, "type": "integer", "description": "Include indicator values from this year onward." }, "indicatorYearTo": { "title": "Indicator year to", "minimum": 1960, "maximum": 2030, "type": "integer", "description": "Include indicator values up to this year." }, "maxIndicatorRecords": { "title": "Maximum indicator records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap indicator rows across selected indicators, countries, and years.", "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 } } } } } } } } } } ```