# UK Public Sector Tender Tracker (`cardinal_radiance_bce/apify-uk-tender-tracker`) Actor

Pull UK public procurement tenders from Find a Tender and Contracts Finder (OCDS JSON APIs, free, Open Government Licence v3.0, no API key). One row per tender: buyer, title, CPV codes, value, deadline, delivery region and official notice link. For UK bid teams and public-sector suppliers.

- **URL**: https://apify.com/cardinal_radiance_bce/apify-uk-tender-tracker.md
- **Developed by:** [Tristan Evans](https://apify.com/cardinal_radiance_bce) (community)
- **Categories:** Business, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

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

## apify-uk-tender-tracker — UK Public Sector Tender Tracker

**What you get** — A feed of UK public sector tenders from Find a Tender and Contracts Finder, delivered as structured rows: buyer, title, CPV codes, value, deadline, region and document link. Built for UK bid teams, public-sector sales teams and suppliers who need to see what's out for tender before the deadline passes, without checking government websites by hand.

### What it does

- Pulls notices from the official Find a Tender OCDS API and the Contracts Finder OCDS feed — free, Open Government Licence v3, no API key, no registration
- Returns one structured row per tender, newest first
- Filters by keyword, CPV code, region, buyer and publication date
- Saves results to the Apify dataset; export to JSON, CSV or Excel via the Apify API

### Pricing

Pay-per-event on Apify Store: **$0.003 per tender returned**. The first **50 tenders per run are free**. You pay only for tenders saved to your dataset — not for pages scanned or empty runs.

- 50 tenders: $0.00
- 200 tenders: $0.45 (50 free + 150 × $0.003)
- 1,000 tenders: $2.85 (50 free + 950 × $0.003)

Small weekly bid lists (under 50 tenders per run) cost nothing.

### Input

Example input:

```json
{
  "sources": ["find-tender", "contracts-finder"],
  "keyword": "software",
  "cpv": "48000000",
  "region": "England",
  "maxResults": 100,
  "fromPublished": "2026-11-01",
  "includeDocumentLinks": true
}
```

| Field | Type | Description |
|---|---|---|
| `sources` | array | `"find-tender"` and/or `"contracts-finder"` (default both) |
| `keyword` | string | Search text matched against title and description |
| `cpv` | string | CPV procurement code filter (e.g. `48000000` for software) |
| `region` | string | UK region or nation (e.g. `England`, `North West`) |
| `maxResults` | integer | Max tenders to return (default 100) |
| `fromPublished` | string | Only notices published on or after this date (YYYY-MM-DD) |
| `includeDocumentLinks` | boolean | Include the official notice document link |

### Output

One row per tender, saved to the default dataset:

| Field | Type | Description |
|---|---|---|
| `tenderId` | string | Notice ID from the source portal |
| `source` | string | `find-tender` or `contracts-finder` |
| `title` | string | Tender title |
| `buyer` | string | Buying organisation |
| `cpvCodes` | array | CPV codes assigned to the notice |
| `valueGBP` | number/null | Stated value in GBP, or null if not published |
| `deadline` | string | Tender deadline (ISO 8601) |
| `region` | string | Buyer region |
| `documentLink` | string|null | Link to the official notice documents |
| `publishedDate` | string | Date the notice was published |

#### Example output (3 tenders)

| tenderId | buyer | title | valueGBP | deadline | region | documentLink |
|---|---|---|---|---|---|---|
| FTS-2026-11-00147 | Manchester University NHS Foundation Trust | Electronic prescribing and medicines administration system | 2400000 | 2027-02-14T17:00:00Z | North West | https://www.find-tender.service.gov.uk/Notice/... |
| CF-2026-11-03821 | Birmingham City Council | Highways resurfacing and patching works 2027 | 8500000 | 2027-03-01T12:00:00Z | West Midlands | https://www.contractsfinder.service.gov.uk/Notice/... |
| FTS-2026-11-00512 | Department for Education | Panel of suppliers — school catering services | 12000000 | 2027-03-22T17:00:00Z | England | https://www.find-tender.service.gov.uk/Notice/... |

*Example rows illustrate the output shape; values are typical of real notices on both portals.*

### Notes

- Data comes directly from `find-tender.service.gov.uk` and `contractsfinder.service.gov.uk` OCDS endpoints (verified live 2026-11-19). Neither requires an API key.
- Published under the Open Government Licence v3.0 — commercial use is permitted with attribution.
- CPV codes are the EU common procurement vocabulary used on UK procurement notices.
- `valueGBP` and `deadline` are null where the source notice does not state them.

### FAQ

**Q: What does it cost?**\
A: $0.003 per tender returned, first 50 tenders free per run, pay-per-event on Apify Store.

**Q: Do I need an API key or government account?**\
A: No. Both portals publish open OCDS feeds that anyone can call.

**Q: Which sources does it cover?**\
A: Find a Tender (higher-value UK procurement, including Procurement Act 2023 notices) and Contracts Finder (mainly lower-value England contracts).

**Q: Can I use the data commercially?**\
A: Yes. The data is public sector information under the Open Government Licence v3.0 — commercial use is allowed with attribution.

**Q: Why did my run return 0 tenders?**\
A: Try removing the keyword, CPV or region filter, or widen the date range. Notices are only returned if they match every filter you set.

### Price comparison

| Actor | Per tender | Per 1,000 tenders | Free allowance |
|---|---|---|---|
| apify-uk-tender-tracker | $0.003 | $3.00 | First 50 free per run |
| uk-tenders-scraper (compass_lab) | ~$0.004 | ~$4.00 | None |
| uk-find-tender-notices-scraper (neuton) | ~$0.001 | $1.00 | None advertised |

With the first 50 tenders free in every run, we're the cheapest option for typical bid-team volumes (under ~75 tenders per run versus the $1-per-1,000 competitor, and always cheaper than $4-per-1,000 actors).

### Also see

- [uk-food-hygiene-ratings](../uk-food-hygiene-ratings/README.md) — FSA food hygiene ratings, $0.003 per record, first 50 free
- [career-jobs](../career-jobs/README.md) — Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee jobs ($3/1k jobs)
- [workday-jobs-api](../workday-jobs/README.md) — every job from any Workday career site ($1/1k jobs)
- [website-contact-extractor](../contact-extractor/README.md) — business emails, phones and socials per domain ($1.50/1k sites)
- [article-scraper](../web-scraper/README.md) — article titles, authors, dates, tags and CTA links ($2/1k articles)
- [bulk-domain-check](../domain-check/README.md) — domain availability, RDAP, DNS and SPF/DMARC in bulk ($1/1k domains)

### License

Contains public sector information licensed under the Open Government Licence v3.0.

# Actor input Schema

## `mode` (type: `string`):

How to find tenders: most recent, by buyer, or by UK delivery region

## `buyer` (type: `string`):

Named buyer to filter by (e.g. a council or department). Required for buyer mode.

## `region` (type: `string`):

Filter tenders delivering to this UK region (e.g. London, South East).

## `limit` (type: `integer`):

Maximum number of tenders to extract (1-500).

## Actor input object example

```json
{
  "mode": "recent",
  "buyer": "Department for Education",
  "region": "London",
  "limit": 20
}
```

# Actor output Schema

## `total_found` (type: `string`):

Total tenders matching the search criteria

## `returned` (type: `string`):

Number of tenders extracted

# 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 = {
    "buyer": "",
    "region": "",
    "limit": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("cardinal_radiance_bce/apify-uk-tender-tracker").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 = {
    "buyer": "",
    "region": "",
    "limit": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("cardinal_radiance_bce/apify-uk-tender-tracker").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 '{
  "buyer": "",
  "region": "",
  "limit": 20
}' |
apify call cardinal_radiance_bce/apify-uk-tender-tracker --silent --output-dataset

```

## MCP server setup

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

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/iW07gq00iW6EdXw2r/builds/Rab9IPx7gV4ZKTg0P/openapi.json
