DEV Community

FedSignals Data
FedSignals Data

Posted on

How to Get Daily World Bank Tender Alerts by Country and Keyword (Python, No API Key)

Pull new World Bank procurement notices for the countries and keywords you bid on, keep only the ones still open, and get only new notices each day.

Written with AI assistance and reviewed by the FedSignals Data team; we maintain these tools.

World Bank-financed projects advertise invitations for bids, requests for expressions of interest (consulting), general procurement notices and prequalification on the Bank's procurement site. That covers 180+ countries and regions and adds up to around 50 new bid and consulting opportunities a day. If you supply goods, works or consulting services on Bank-financed projects, this is where your next opportunity shows up.

The data is free and open, but turning it into a daily "new World Bank tenders for us" list takes some work:

  • The World Bank site's own saved searches land in a browser or inbox. You can't easily send them to Slack, a CRM or a bid/no-bid script.
  • The World Bank Search API is open and needs no key, but you have to learn its query parameters, map notice types and procurement methods, drop notices whose deadline has passed, and remember which notices you already handled.

We built the World Bank Tenders Monitor: Procurement Notices Actor on Apify to do that part, and this tutorial walks through it. It calls the official World Bank Search API (no scraping, no login), filters by country or region, keywords, notice type, procurement group and method, and returns only notices it hasn't delivered before.

What you'll build

  • A daily list of new World Bank invitations for bids and consulting EOIs for the countries and keywords you pick, with buyer, project, deadline and a link to the notice page.
  • Only notices you can still bid on: closed notices are dropped by default.
  • A daily run that returns, and charges for, only notices it hasn't delivered before.
  • A Slack message (or webhook to your CRM) with each day's new tenders.

Step 1: Run it once by hand

Open apify.com/fedsignals/world-bank-procurement-notices and click Try for free. The prefilled input looks like this:

{
  "countries": ["Kenya", "Bangladesh", "Georgia"],
  "noticeTypes": ["invitationForBids", "expressionOfInterest"],
  "publishedWithinDays": 14,
  "openOnly": true,
  "onlyNew": false,
  "maxItems": 10
}
Enter fullscreen mode Exit fullscreen mode

It asks for invitations for bids and requests for expressions of interest from Kenya, Bangladesh and Georgia, published in the last 14 days, that are still open. Countries accept Kenya, KE or KEN, and regions such as Western and Central Africa. A misspelling such as Kenyya stops the run before anything is charged, with a "Did you mean 'Kenya'?" message. The run takes a few seconds, and with maxItems: 10 it costs at most about $0.03.

Step 2: Look at the output

Each row is one notice. Here is one from a real run (Nov 6, 2026):

{
  "noticeId": "OP00479212",
  "noticeType": "Invitation for Bids",
  "title": "Supply and Installation of Early Streamer Emission Lighting Protection System in Coxs Bazar District & in Hatiya, Noakhali District.",
  "projectId": "P501274",
  "projectName": "Host and Rohingya Enhancement of Lives Project",
  "country": "Bangladesh",
  "buyerOrganization": "Local Government Engineering Department",
  "procurementGroup": "Goods",
  "procurementGroupCode": "GO",
  "procurementMethod": "Request for Bids",
  "procurementMethodCode": "RFB",
  "bidReference": "HELP/GD/10",
  "noticeLanguage": "English",
  "publishedDate": "2026-11-05",
  "submissionDeadlineDate": "2026-11-24",
  "submissionDeadlineLocalTime": "13:00",
  "url": "https://projects.worldbank.org/en/projects-operations/procurement-detail/OP00479212",
  "licence": "CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/), World Bank Terms of Use for Datasets",
  "source": "The World Bank: World Bank Procurement Notices: search.worldbank.org/api/v2/procnotices (licensed under CC BY 4.0; changes: fields renamed and reformatted, contact details and notice text omitted)",
  "scrapedAt": "2026-11-06T17:05:02Z"
}
Enter fullscreen mode Exit fullscreen mode

A few fields worth knowing:

  • title, projectName and buyerOrganization are as the borrower published them.
  • publishedDate and submissionDeadlineDate are calendar dates (YYYY-MM-DD). submissionDeadlineLocalTime is the deadline time (HH:MM) in the borrower's local time, exactly as written in the notice — it is not UTC.
  • url goes to the notice page, where the bid documents and how to apply live. Contact persons, emails and phone numbers are never collected.
  • Contract award notices are not included, because they list individual bidders.

Every run also writes a SUMMARY record to its key-value store. It shows your filters, how many notices matched, what was skipped and why the run stopped:

{
  "filters": {
    "keywords": [],
    "countries": ["Kenya", "Bangladesh", "Georgia"],
    "noticeTypes": ["invitationForBids", "expressionOfInterest"],
    "procurementGroups": [],
    "procurementMethods": [],
    "publishedWithinDays": 14,
    "openOnly": true
  },
  "publishedSince": "2026-10-23",
  "searches": [
    {
      "keyword": null,
      "totalMatching": 5503,
      "pages": 1,
      "inWindow": 47
    }
  ],
  "scanned": 48,
  "matched": 7,
  "delivered": 6,
  "skippedAlreadySeen": 0,
  "skippedClosed": 1,
  "skippedMethod": 0,
  "byNoticeType": {
    "Invitation for Bids": 2,
    "Request for Expression of Interest": 4
  },
  "byCountry": {
    "Bangladesh": 5,
    "Kenya": 1
  },
  "stopReason": "spendingLimit",
  "maxItems": 10,
  "onlyNew": false,
  "partialFailures": [],
  "firstRunForState": false,
  "requests": 2,
  "finishedAt": "2026-11-06T17:05:02Z"
}
Enter fullscreen mode Exit fullscreen mode

We ran this one with a $0.02 maximum charge, so it stopped cleanly after 6 notices (stopReason: spendingLimit) even though more matched in the window. Without a charge limit it stops at maxItems.

Step 3: Call it from Python

This runs the Actor synchronously and prints each new notice. It reads your Apify token from an environment variable (never paste it into code). maxTotalChargeUsd caps what the run can charge.

import os
import requests

ACTOR = "fedsignals~world-bank-procurement-notices"
URL = f"https://api.apify.com/v2/acts/{ACTOR}/run-sync-get-dataset-items"

run_input = {
    "countries": ["Kenya", "Bangladesh", "Georgia"],
    "noticeTypes": ["invitationForBids", "expressionOfInterest"],
    "publishedWithinDays": 14,
    "openOnly": True,                      # drop notices whose deadline date has passed
    "onlyNew": True,                       # only notices this stateKey hasn't returned before
    "stateKey": "wb-tenders-ke-bd-ge",     # one key per saved search
    "maxItems": 5,
}

resp = requests.post(
    URL,
    params={"maxTotalChargeUsd": 0.02},
    headers={"Authorization": f"Bearer {os.environ['APIFY_TOKEN']}"},
    json=run_input,
    timeout=300,
)
resp.raise_for_status()

for n in resp.json():
    due = n.get("submissionDeadlineDate") or "no deadline"
    local = n.get("submissionDeadlineLocalTime") or ""
    due_s = f"{due} {local}".strip()
    print(f"{n['noticeId']}  {n['country']}  due {due_s}")
    print(f"    {n['buyerOrganization']}: {n['title']}")
    print(f"    {n['url']}")
Enter fullscreen mode Exit fullscreen mode

Run it twice. The second run doesn't repeat anything from the first: onlyNew remembers every notice delivered for that stateKey, skips those for free, and moves on to notices you haven't seen. In a daily schedule that means each run returns only what the World Bank published since the day before.

Two inputs we use a lot:

  • keywords: comma-separated words or phrases, e.g. "solar, mini-grid, water supply". Each keyword is a separate search; results are merged (max 10). Add translations when notices are published in French, Spanish or Portuguese.
  • procurementGroups / procurementMethods: narrow to goods, works, consultingServices or method codes such as RFB, QCBS, INDV. Notices without a method are dropped when a method filter is set.

Step 4: Only notices you can still bid on

With openOnly: true (the default), the Actor drops notices whose submissionDeadlineDate has already passed. It compares that calendar date with today's date in UTC, so a notice due today is still returned. Notices without a deadline are kept. Closed notices are skipped for free and counted in SUMMARY.skippedClosed. Set openOnly: false if you want closed notices too, for example for market research.

Step 5: Schedule it daily

  1. In the Apify console, click Save as a new task with your countries, keywords and notice types. Keep onlyNew: true and set a stateKey.
  2. Go to Schedules → Create new, use the cron expression 0 7 * * * (7:00 daily), set your timezone, and attach the task.

publishedWithinDays can stay at 7 or 14: thanks to onlyNew, the overlap between days costs nothing.

Step 6: Send new tenders to Slack or a webhook

Add a webhook for ACTOR.RUN.SUCCEEDED that points at a small function you host. The payload includes resource.defaultDatasetId:

import os
import requests

def handler(payload: dict) -> None:
    dataset_id = payload["resource"]["defaultDatasetId"]
    notices = requests.get(
        f"https://api.apify.com/v2/datasets/{dataset_id}/items",
        headers={"Authorization": f"Bearer {os.environ['APIFY_TOKEN']}"},
        timeout=60,
    ).json()
    if not notices:
        return  # nothing new today

    lines = [f"*{len(notices)} new World Bank tender{'s' if len(notices) != 1 else ''}*"]
    for n in notices[:30]:
        due = n.get("submissionDeadlineDate") or "no deadline"
        lines.append(
            f"• <{n['url']}|{n['noticeId']}> {n['country']} · {n['buyerOrganization']}: {n['title'][:120]} (due {due})"
        )
    requests.post(os.environ["SLACK_WEBHOOK_URL"], json={"text": "\n".join(lines)}, timeout=30)
Enter fullscreen mode Exit fullscreen mode

A note on consulting EOIs and awards

Set noticeTypes to include expressionOfInterest (the default already does) when you want requests for expressions of interest for consulting firms and individual consultants. Use procurementGroups: ["consultingServices"] and methods such as QCBS, CQS or INDV to narrow further.

Contract award notices are intentionally left out: they list every bidder, and many bidders are individual consultants or sole traders. To keep personal data out of your dataset, this Actor only returns notices that invite bids or interest. Contact names, emails, phone numbers and addresses are never requested; the contact office is on each notice page (url).

What it costs

Pay per event: $0.003 per notice ($3 per 1,000), plus Apify's $0.00005 run-start fee. A daily run that returns 20 new notices costs about $0.06, or about $1.80 a month. A run with nothing new costs only the start fee. Already-seen and closed notices are skipped for free. Set maxItems or a maximum charge per run to cap the cost; the run stops cleanly before going over it (start fee included). If the input is invalid, the run stops before any notice is charged: no results were charged; only Apify's small start fee ($0.00005) applied.

FAQ

Do I need a World Bank account or API key?
No. The World Bank Search API is open and needs no authentication, and the Actor doesn't log in anywhere.

Why are contract awards not included?
Award notices list every bidder, and many bidders are individual consultants or sole traders. To keep personal data out of your dataset, this Actor only returns notices that invite bids or interest.

Why did my run return no notices?
The status message says why: nothing new since the last run (with onlyNew), every match already closed (with openOnly), or no matches at all. Try more publishedWithinDays or fewer filters. The SUMMARY record shows the totals for each search.

My country isn't recognized.
Use the World Bank's English name (e.g. Viet Nam, Congo, Democratic Republic of, Turkiye) or the 2/3-letter ISO code. The error message suggests the closest name. Regional projects use region names such as Western and Central Africa or South Asia.

Which countries are covered?
World Bank-financed procurement in Africa, Asia, Latin America and the Caribbean, Europe and Central Asia, the Middle East and the Pacific, including regional projects. publishedWithinDays goes back up to 90 days.

Related


Last updated: Nov 10, 2026 (tested against Actor build 0.1.5).

FedSignals Data builds small public-data monitors on Apify. Source: The World Bank, Procurement Notices (https://datacatalog.worldbank.org/search/dataset/0037795/world-bank-procurement-notices), licensed under CC BY 4.0. Data is retrieved from the World Bank Search API (https://search.worldbank.org/api/v2/procnotices) and reformatted (fields renamed, contact details omitted). Your use of the data is subject to the World Bank Terms of Use for Datasets. FedSignals Data is not affiliated with, or endorsed by, the World Bank. Questions or feature requests: fedsignals.alerts@gmail.com.

Top comments (0)