# Bahrain Tender Radar — Tender Board Tenders, Bids & Awards (`dottti/bahrain-tender-radar`) Actor

Bahrain government tenders from the Tender Board e-tendering portal as clean JSON: live tenders, closed and opened tenders, awarded tenders, every opened bid with supplier and quoted price in BHD, and the suppliers who bought the documents.

- **URL**: https://apify.com/dottti/bahrain-tender-radar.md
- **Developed by:** [Dottti](https://apify.com/dottti) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 tender delivereds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Bahrain Tender Radar: Tender Board Tenders, Bids and Awards

Get Bahrain government tenders from the [Tender Board e-tendering portal](https://etendering.tenderboard.gov.bh) as clean JSON, CSV or Excel.

The Actor reads all four public lists of the portal:

- **Live tenders.** Open for document purchase and bidding.
- **Bids closed.** Bidding has ended and the bids wait to be opened.
- **Bids opened.** Under evaluation. Each tender can carry every opened bid: supplier, offer type and total quoted value in BHD.
- **Awarded.** With the award date and every opened bid.

You can also add the list of every supplier that bought the tender documents, with the purchase time and whether it submitted a bid.

### Who uses this

- **Suppliers and contractors** get a daily list of new tenders in their field.
- **Bid teams** see who they compete against and at what price, from past openings and awards.
- **Sales and market analysts** track which companies win in each sector, and at what prices.
- **Consultancies** watch purchasing authorities such as Bapco, the Ministry of Works or EWA for their clients.

Bidding elsewhere in the Gulf? See [Gulf Tenders](https://apify.com/dottti/gulf-tenders), [Etimad Tender Radar](https://apify.com/dottti/etimad-tender-radar) for Saudi Arabia and [Oman Tender Radar](https://apify.com/dottti/oman-tender-radar).

### Daily tender alert in 3 steps

1. Set your filters. For example, `view` = `NewTenders` and `keywords` = `["maintenance"]`.
2. Click **Save as a new task**, then add a daily schedule to the task.
3. Connect the task to email, Slack or Google Sheets from the **Integrations** tab.

### What you get

One record per tender, newest first. This awarded tender comes from a real run on 20 October 2026 (the bid list is shortened to 2 of 3 bids, the buyer list to 1 of 3):

```json
{
  "tenderNumber": "186/2026/BTB (PT/CSD/MA/2026/021(LTC))",
  "purchasingAuthorityRef": "PT/CSD/MA/2026/021(LTC)",
  "internalId": "11061",
  "title": "Supply of Pipe, DI SPIGOT and Socket 150MM and Accessories",
  "purchasingAuthority": "Bahrain Tender Board",
  "section": "Procurement",
  "category": "General",
  "activityCode": "1065",
  "activity": "Energy & Utilities (Oil, Power generation, Energy, Fuel, Electricity, Solar systems, smart meters, utility infrastructure services)",
  "view": "AwardedTenders",
  "status": "Awarded",
  "awardedOn": "2026-10-20T09:43:00+03:00",
  "currency": "BHD",
  "tenderFeeBhd": 100,
  "initialBondBhd": 4000,
  "bondValidity": "180 Days",
  "bidCount": 3,
  "lowestBid": { "supplier": "YOUSIF KHALIL ALMOAYYED AND SONS BSC", "quotedValueBhd": 149848.68, "offerType": "Main" },
  "bids": [
    { "rank": 1, "supplier": "INFRASHORE COMPANY W.L.L", "offerType": "Main", "quotedValueBhd": 158378.572, "quotedValueText": "158378.572", "status": "Financial Bid Opened" },
    { "rank": 2, "supplier": "MOHAMMED FAKHROO & BROTHERS W.L.L", "offerType": "Main", "quotedValueBhd": 168154.4, "quotedValueText": "168154.4", "status": "Financial Bid Opened" }
  ],
  "participants": {
    "suppliers": [
      { "bidNumber": "31280", "supplier": "INFRASHORE COMPANY W.L.L", "documentPurchasedAt": "2026-04-20T16:46:31+03:00", "submissionStatus": "Submitted" }
    ],
    "submittedCount": 3,
    "purchasedCount": 3
  }
}
```

A live tender carries the bidding dates instead:

```json
{
  "tenderNumber": "477/2026/BTB (BE2630000644)",
  "title": "Long Term Agreement for the Supply of Consumables",
  "purchasingAuthority": "Bahrain Tender Board",
  "documentSalesStart": "2026-10-11T16:31:00+03:00",
  "documentSalesEnd": "2026-10-25T16:31:00+03:00",
  "bidClosing": "2026-11-15T13:30:00+03:00",
  "bidOpening": "2026-11-16T08:00:00+03:00",
  "tenderFeeBhd": 100,
  "initialBondBhd": 2500
}
```

#### Notes on the fields

- **Money.** All amounts are Bahraini dinars. The `currency` field says `BHD` and the field names end in `Bhd`.
- **Dates** are ISO 8601 in Bahrain time (`+03:00`). The text as published is kept in `raw`.
- **`lowestBid`** is the lowest priced offer among the opened bids. The portal does not publish the winner's name in a field, so this is the lowest offer, which is not always the winning one.
- **`bids`** is filled for the opened and awarded lists when `includeBids` is on. It stays `null` for live and closed tenders.
- **`participants`** is filled when `includeParticipants` is on. It stays `null` for live tenders.
- **Missing values** are `null`. The Actor never fills a gap with a guess.

### Input

| Field | What it does |
| --- | --- |
| `view` | `NewTenders` (default), `ToBeOpenedTenders`, `InProcessTenders` or `AwardedTenders`. |
| `keywords` | Words matched against title, description, purchasing authority, activity and tender number. Not case-sensitive. |
| `matchMode` | `any` (default) or `all`. |
| `authorityContains` | Keep tenders whose purchasing authority contains this text, for example `Bapco`. |
| `activityContains` | Keep tenders whose activity contains this text or code, for example `Consumables` or `1074`. |
| `sinceDate` | `YYYY-MM-DD`. Keep tenders whose latest date is on or after this date. |
| `includeBids` | Opened and awarded lists. Adds every opened bid. On by default. |
| `includeParticipants` | Adds every supplier that bought the documents. Off by default. |
| `maxItems` | Hard cap on delivered tenders, and so on cost. Default 100. |

#### Example: this month's awards with bids

```json
{
  "view": "AwardedTenders",
  "sinceDate": "2026-10-01",
  "includeBids": true,
  "maxItems": 200
}
```

#### Example: who bids on Bapco tenders

```json
{
  "view": "InProcessTenders",
  "authorityContains": "Bapco",
  "includeBids": true,
  "includeParticipants": true,
  "maxItems": 100
}
```

### Pricing

- **Tender delivered:** $0.005 per tender that passes your filters and is stored in your dataset ($5 per 1,000).
- **Bid report:** $0.02 extra per tender that carries opened bids with suppliers and prices ($20 per 1,000). Only opened and awarded tenders can have one. Turn off `includeBids` to skip it.

Filtering is free. You pay only for tenders delivered. `maxItems` caps the cost of any run.

### Limits

- Each list comes from the portal in one response. On 20 October 2026 the lists held 57 live, 1,358 closed, 3,282 opened and 733 awarded tenders.
- Filters run on the Actor's side after the list is read, so a narrow filter costs nothing extra.
- The Actor connects directly with an honest client name and no proxy. If the portal refuses the connection, the run retries with backoff and then stops with a clear error; it does not try to get around a block.
- The Actor waits at least 1 second between requests and retries with backoff on HTTP 429, 5xx and network errors. Each delivered tender costs one extra request with `includeBids` and one more with `includeParticipants`.
- Titles are in English as the portal publishes them.
- Tender documents are sold on the portal and are not downloaded.
- Data comes from the public pages of the Tender Board portal. No login and no credentials are used.

### Development

```bash
npm install
npm test        # parser tests on saved live pages
apify run       # local run, reads storage/key_value_stores/default/INPUT.json
```

# Actor input Schema

## `view` (type: `string`):

Which public list of the Bahrain Tender Board to read. Live: open for bidding (about 60). Bids closed: waiting to be opened (about 1,400). Bids opened: under evaluation, with every bid and price (about 3,300). Awarded: with the award date and every bid (about 730).

## `keywords` (type: `array`):

Words matched against the tender title, description, purchasing authority, activity and tender number. Not case-sensitive. Leave empty to return everything the other filters allow.

## `matchMode` (type: `string`):

any: keep a tender when at least one keyword matches. all: keep it only when every keyword matches.

## `authorityContains` (type: `string`):

Keep only tenders whose purchasing authority contains this text, for example Ministry of Works or Bapco.

## `activityContains` (type: `string`):

Keep only tenders whose commodity activity contains this text or code, for example Consumables, Information Technology or 1074.

## `sinceDate` (type: `string`):

YYYY-MM-DD. Keep tenders whose latest date (awarded on, bid opening, bid closing or document sales start) is on or after this date.

## `includeBids` (type: `boolean`):

For opened and awarded tenders, add every opened offer: supplier, offer type, total quoted value in BHD and status, plus the lowest bid. Adds one request per delivered tender and a bid-report charge per tender that has bids.

## `includeParticipants` (type: `boolean`):

Add every supplier that bought the tender documents, with purchase time and whether it submitted a bid. Not available for live tenders. Adds one request per delivered tender.

## `maxItems` (type: `integer`):

Hard cap on delivered tenders, newest first. You are charged per tender delivered, so this is also your cost cap.

## `requestDelayMs` (type: `integer`):

Pause before each request to the government portal. Never lower than 1000 ms; lower values are raised to 1000.

## `maxRetries` (type: `integer`):

Retries with exponential backoff when the portal answers 429 or 5xx, or the network fails.

## Actor input object example

```json
{
  "view": "NewTenders",
  "keywords": [
    "maintenance"
  ],
  "matchMode": "any",
  "includeBids": true,
  "includeParticipants": false,
  "maxItems": 20,
  "requestDelayMs": 1000,
  "maxRetries": 5
}
```

# Actor output Schema

## `tenders` (type: `string`):

Matching tenders: number, title, purchasing authority, activity, dates, fee and bond in BHD and, for opened and awarded tenders, every bid with its quoted price.

# 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 = {
    "keywords": [
        "maintenance"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("dottti/bahrain-tender-radar").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 = {
    "keywords": ["maintenance"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("dottti/bahrain-tender-radar").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 '{
  "keywords": [
    "maintenance"
  ],
  "maxItems": 20
}' |
apify call dottti/bahrain-tender-radar --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dottti/bahrain-tender-radar"
        }
    }
}
```

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/2FCCzXR7DB7Vjhhio/builds/TVtMK0fnNNNOEiQ95/openapi.json
