projects.worldbank.org APIprojects.worldbank.org ↗
Search World Bank projects and procurement notices. Access funding amounts, sector data, country info, and tender deadlines via 3 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/7af0fc2e-0427-4b22-9b30-7e6d5b353eee/search_projects?limit=3&query=infrastructure&status=Active' \ -H 'X-API-Key: $PARSE_API_KEY'
Search World Bank projects by keyword with optional status filter. Returns paginated project details including funding, sector, country, and abstract.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results (max 100). |
| query | string | Search keyword(s). |
| offset | integer | Pagination offset (0-based). |
| status | string | Filter by project status. Accepted values: Active, Closed, Pipeline, Dropped. Omitting returns all statuses. |
{
"type": "object",
"fields": {
"count": "integer number of projects in this response",
"total": "integer total matching projects",
"offset": "integer pagination offset used",
"projects": "array of project objects with id, project_name, country, status, sector, total_amount_usd, abstract, url, and other fields"
},
"sample": {
"data": {
"count": 1,
"total": 46,
"offset": 0,
"projects": [
{
"id": "P179950",
"url": "https://projects.worldbank.org/en/projects-operations/project-detail/P179950",
"region": "Europe and Central Asia",
"sector": "",
"status": "Active",
"themes": "",
"country": [
"Georgia"
],
"abstract": "The objective of the Enhancing Energy Security...",
"borrower": "Georgia",
"team_leader": "Florian Kitt,Sameh I. Mobarek",
"closing_date": "6/30/2029 12:00:00 AM",
"country_code": "Georgia",
"grant_amount": "",
"last_updated": "2024-05-23 00:00:00.0",
"lending_cost": "50,000,000",
"project_name": "Enhancing Energy Security through Power Interconnection and Renewable Energy Program",
"financial_type": [
"IBRD"
],
"ida_commitment": "0",
"ibrd_commitment": "35,000,000",
"total_amount_usd": "35,000,000",
"lending_instrument": "Investment Project Financing",
"board_approval_date": "2024-05-21T00:00:00Z",
"implementing_agency": "Georgian State Electrosystem",
"total_commitment_usd": "35,000,000"
}
]
},
"status": "success"
}
}About the projects.worldbank.org API
This API provides structured access to the World Bank projects database through 3 endpoints, covering project search, procurement notice lookup, and detailed project retrieval. The search_projects endpoint returns paginated results with fields like total_amount_usd, sector, country, status, and abstract. The search_procurement endpoint surfaces active and historical tender notices including bid descriptions, deadlines, and contact emails.
Endpoints and Data Coverage
The API exposes three endpoints. search_projects accepts a query string and an optional status filter (Active, Closed, Pipeline, or Dropped) to search the World Bank's full project catalog. Each result includes id, project_name, country, sector, total_amount_usd, abstract, and a url pointing to the project page. Pagination is controlled via limit (up to 100) and offset parameters, with total in the response indicating how many matching records exist.
Procurement Notices
search_procurement searches tender and bid notices associated with World Bank-financed operations. Results include notice_type, notice_status, project_id, bid_description, and contact_email. This is useful for tracking active procurement opportunities tied to specific projects or sectors. Like search_projects, it supports limit, offset, and keyword query inputs.
Project Details
get_project_details takes a single required project_id (e.g. P179950) and returns the full record for that project: region, sector (array or string), country (array or string), abstract, total_amount_usd, status, country_code, and the canonical url. This endpoint is suited for building detailed project profiles or enriching records returned by the search endpoints.
- Monitor active World Bank procurement tenders in a specific sector using
search_procurementwith keyword filters - Build a project funding tracker by querying
search_projectsfiltered toActivestatus and extractingtotal_amount_usdby country - Enrich a development finance database with project abstracts, sector tags, and region data via
get_project_details - Alert contractors to new bid opportunities by polling
search_procurementfor notices matching their domain keywords - Map World Bank investment flows by aggregating
countryandtotal_amount_usdfields across paginatedsearch_projectsresults - Filter pipeline projects by sector to identify upcoming funding in specific regions before formal approval
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the World Bank have an official developer API for project data?+
What does the `status` filter in `search_projects` accept?+
status parameter accepts four values: Active, Closed, Pipeline, and Dropped. Omitting the parameter returns projects across all statuses. The total field in the response reflects the count of all matching records regardless of page size.Does `search_procurement` include procurement documents or attachments?+
search_procurement endpoint returns notice metadata — bid_description, notice_type, notice_status, project_id, and contact_email — but not linked documents or file attachments. You can fork this API on Parse and revise it to add an endpoint that retrieves attached documents for a given notice.Can I retrieve a list of all projects for a specific country directly?+
query and status. You can query by country name as a keyword in search_projects, but results depend on keyword matching against project text fields. You can fork this API on Parse and revise it to add a country-code filter endpoint.How reliable is the `total_amount_usd` field across projects?+
$50,000,000) and reflects the total commitment amount as recorded in the World Bank's project database. Some pipeline or dropped projects may have a null or zero value if financing was not finalized.