# World Bank Project Records — Development Pipeline (`nexgensignal/world-bank-project-records`) Actor

Per-record World Bank development projects from the official Projects & Operations API. Country, sector, financing, commitments, dates. Keyless, CC BY 4.0, no personal data.

- **URL**: https://apify.com/nexgensignal/world-bank-project-records.md
- **Developed by:** [NexGen Signal](https://apify.com/nexgensignal) (community)
- **Categories:** Business, News, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $33.50 / 1,000 project records

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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Project Records — Development Pipeline

**Official source. No API key. Pay per record.**

This actor turns the **World Bank's Projects & Operations** database into clean, per-project records — the full development-finance pipeline, at the grain an organization tracks when it follows where multilateral money is going. Each run reads the official search.worldbank.org API and delivers one row per project: the project id and name, the country and region, the sector and themes, the financing stage and commitment amounts, and the approval and closing dates — project and organization grain, licensed CC BY 4.0, with no task-team-leader or other person data.

### What this is, in one paragraph

The World Bank publishes every lending project — active, pipeline, closed, and dropped — through a keyless API. This actor reads that API, paginates through the full set, and flattens each project into a single analysis-ready row: what it is, which country and region it serves, which sector and themes it addresses, how it is financed (IBRD/IDA commitments and totals), and when it was approved and closes. Values are verbatim. You are billed only for records actually delivered.

### Who buys this and for what job

- **Development-finance and consulting firms** tracking the World Bank pipeline by country, sector, or financing instrument to find and size opportunities.
- **Suppliers and contractors** watching which projects are moving toward procurement in their markets.
- **Researchers, NGOs, and journalists** analyzing where development commitments flow, by region and theme.
- **Analysts and data engineers** who want a keyless, one-call feed of the World Bank project pipeline already reduced to project/org fields.

### Licence — CC BY 4.0, commercial use permitted

World Bank Projects & Operations data is a World Bank-produced dataset and carries the World Bank's default dataset licence: **Creative Commons Attribution 4.0 (CC BY 4.0)**. The World Bank states this licence lets you *"copy, modify and distribute data in any format for any purpose, including commercial use"*, provided you give appropriate credit. Every record carries the required attribution: *"The World Bank: World Bank Projects & Operations: search.worldbank.org (CC BY 4.0)."* These are project metadata records for pipeline tracking — not investment, development, or financial advice.

### Project / organization grain — no person data

This actor works at project and organization grain. The World Bank's project data includes a task-team-leader (TTL) name — a natural person — which this actor **never requests and never emits**: it is left out of the field list entirely, so it cannot enter a record. As a second, structural safeguard, the project abstract (a free-text field that occasionally echoes a contact) is scrubbed before emit — the TTL name is redacted if present, and any email address or phone-number pattern is removed. This is enforced by an acceptance test that feeds a project whose abstract contains a name, email, and phone and asserts none survive, plus a live sweep over real projects (100 projects each carrying a real TTL name in the source → 0 emitted).

### Pricing

| Event | Free plan | Bronze | Silver | Gold / Platinum / Diamond |
|-------|-----------|--------|--------|---------------------------|
| `project_record` | $0.05 | $0.045 | $0.04 | $0.0335 |

Delivered before charged. Blocked runs and empty results cost nothing.

### Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `countryCode` | string | — | Optional. Keep only projects for this country ISO code (e.g. `RW`, `IN`, `BRA`). |
| `status` | select | Any | Optional status filter: Active, Closed, Pipeline, Dropped. |
| `maxRecords` | integer | 500 | Ceiling on records delivered and billed. |

The actor paginates the API's offset window and paces between pages.

### Output

One JSON object per project. Real example (values verbatim):

```json
{
  "record_id": "P505244",
  "project_id": "P505244",
  "project_name": "Boosting Green Finance, Investment and Trade in Rwanda",
  "country": "Rwanda",
  "country_code": "RW",
  "region": "Eastern and Southern Africa",
  "status": "Active",
  "lending_instrument": "Development Policy Lending",
  "total_commitment": "200,000,000",
  "ibrd_commitment": "0",
  "ida_commitment": "200,000,000",
  "sector": "Public administration",
  "themes": ["Finance"],
  "board_approval_date": "2024-12-20T00:00:00Z",
  "closing_date": "12/20/2025 12:00:00 AM",
  "approval_fy": "2025",
  "project_abstract": "The development objective ... (scrubbed of any contact) ...",
  "source": "World Bank Projects & Operations API",
  "source_url": "https://projects.worldbank.org/en/projects-operations/project-detail/P505244",
  "licence": "World Bank Projects & Operations ... CC BY 4.0 ... including commercial use ...",
  "attribution": "The World Bank: World Bank Projects & Operations: search.worldbank.org (CC BY 4.0).",
  "observed_at": "2026-08-19T00:00:00Z"
}
```

An unbilled `RUN_RECEIPT` records the robots check, the filters, the total matched, projects seen and delivered, and whether charged equals delivered.

### Field reference

Each record is a flat set of pipeline-tracking fields. Identity: `record_id` / `project_id` and `project_name`. Where: `country`, `country_code`, and `region`. Status and instrument: `status`, `lending_instrument`, `lending_instrument_type`, and `product_line`. Money: `total_commitment`, `total_amount`, `ibrd_commitment`, `ida_commitment`, `project_cost`, and `current_total_commitment` (all verbatim strings as published). Classification: `sector` and `themes`. Timing: `board_approval_date`, `closing_date`, and `approval_fy`. Substance: `project_abstract` (the development objective, scrubbed of any contact). Provenance: `source`, `source_url`, `licence`, `attribution`, `disclaimer`, and `observed_at`.

### How a run works

A run first re-reads the source's robots posture from your runtime (the API host serves no robots file, a no-policy posture) and stops at the door if that ever changes. It then builds a single filtered query from your country and status inputs and reads the first page of projects, recording the API's own `total` match count into the run receipt. Each project is flattened to one record — the task-team-leader name dropped, the abstract scrubbed — and delivered **before** it is charged, so a run that is blocked or finds nothing costs you nothing. The actor then walks the offset window page by page, pausing briefly between pages, and stops as soon as either your `maxRecords` ceiling or the total match count is reached. The receipt's `charge_equals_delivered` flag lets you confirm you were billed for exactly what you received.

### Cost guidance

One `project_record` per delivered project: cost = projects delivered × your plan's per-record price. The full pipeline is about **22,729 projects** at the time of writing, so an unfiltered pull is roughly **$1,136** (Free) / **$761** (Gold). A country- or status-scoped pull keeps runs small — Active projects alone number in the low thousands, and a single country is typically a few hundred.

### Honest limitations

- **Project/org grain.** Full project documents, results frameworks, and disbursement histories are not included — this is the project record plus the abstract.
- **Amounts are verbatim strings** as published (with the World Bank's own formatting), not normalized numbers.
- **Point-in-time.** Commitments, status, and closing dates change; re-run to refresh.
- **No task-team-leader or other person data** is emitted, by design.

### Differentiation

Distinct from the procurement cells in this fleet — **eu-tender-bid-signals** (EU TED tenders) and **uk-contract-opportunity-records** (UK Contracts Finder): a tender is a specific contract being competed; this is the **development-finance project pipeline** upstream of any tender. It is also distinct from **fleet-1's korea-ipo-pipeline** (private-capital IPO pipeline, a different institution and market entirely). All named so buyers pick the right one.

### The NexGen Signal family

Part of the NexGen Signal family of official-source, pay-per-record products:

- [Federal Rulemaking Records — US Federal Register](https://apify.com/nexgensignal/federal-rulemaking-records)
- [Grant Opportunity Records — US Grants.gov](https://apify.com/nexgensignal/grant-opportunity-records)
- [EU Tender Bid Signals — TED](https://apify.com/nexgensignal/eu-tender-bid-signals)
- [UK Contract Opportunity Records — Contracts Finder](https://apify.com/nexgensignal/uk-contract-opportunity-records)
- [Organization Sanctions & LEI Risk](https://apify.com/nexgensignal/organization-sanctions-lei-risk)

*Source: World Bank Projects & Operations via the search.worldbank.org API. Licensed CC BY 4.0 (the World Bank's default dataset licence — commercial use permitted with attribution). Reformatted to project/org records; values verbatim; no task-team-leader or other person data emitted.*

# Actor input Schema

## `countryCode` (type: `string`):

Optional. Keep only projects for this country ISO code (e.g. RW, IN, BRA).

## `status` (type: `string`):

Optional project status filter.

## `maxRecords` (type: `integer`):

Maximum records delivered and billed. You are billed only for records delivered.

## Actor input object example

```json
{
  "status": "",
  "maxRecords": 500
}
```

# Actor output Schema

## `results` (type: `string`):

The delivered 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxRecords": 500
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgensignal/world-bank-project-records").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "maxRecords": 500 }

# Run the Actor and wait for it to finish
run = client.actor("nexgensignal/world-bank-project-records").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 '{
  "maxRecords": 500
}' |
apify call nexgensignal/world-bank-project-records --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nexgensignal/world-bank-project-records"
        }
    }
}

```

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 <APIFY_API_TOKEN>` 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/QyqYoiCSEkIE8N7yw/builds/tH1gQRkoFrnGf43Sf/openapi.json