# UK Public Tenders & Awards – Find a Tender + Contracts Finder (`stimulating_stilbite/uk-public-tenders-contracts-finder`) Actor

UK government tenders and contract awards from Find a Tender and Contracts Finder: open tenders with buyer contacts and deadlines, plus winning suppliers with Companies House numbers. Official API.

- **URL**: https://apify.com/stimulating_stilbite/uk-public-tenders-contracts-finder.md
- **Developed by:** [Nordic Data Tools](https://apify.com/stimulating_stilbite) (community)
- **Categories:** Lead generation, Business, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 tender notices

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

## UK Public Tenders & Contract Awards API – Find a Tender + Contracts Finder

Get **UK government tenders and contract awards** as clean JSON/CSV/Excel from both official services, in one run:

- **Find a Tender (FTS)**: the central digital platform for every notice under the **Procurement Act 2023**, plus above-threshold tenders.
- **Contracts Finder**: lower-value public contracts in England (from about £12k / £30k).

For each notice you get the title, description, CPV codes, delivery region, **buyer contact name, e-mail and phone**, estimated value, **tender deadline**, contract dates and SME suitability. Award notices add **winning suppliers with Companies House numbers**, addresses, e-mails, size and awarded value.

Built on the **official OCDS APIs** of the Cabinet Office (Open Government Licence v3.0). No scraping, no login, no API key, no proxies.

👉 Click **Try for free** to get the newest notices in seconds.

### Who uses this

- **Bid teams and SMEs**: a daily feed of new UK tenders in your CPV codes, keywords or region, with deadlines, sent to Sheets, Slack or your CRM.
- **B2B sales and lead gen**: companies that just won public contracts (NHS, councils, universities, MoD), with Companies House numbers and contacts.
- **Competitor and market intelligence**: who wins what, from which buyers, at what value.
- **AI agents and analysts**: structured procurement data without HTML parsing.

### How to get started

1. Pick **What to find**: *Open tenders*, *Contract awards & suppliers*, *Planned / pipeline* or *All*.
2. Add **keywords** (`software`, `cleaning`, `cyber`), **CPV codes** (`72`, `48`, `45`), a **buyer name** (`NHS`, `council`) or **regions** (`UKI` London, `UKM` Scotland).
3. Set the date range (default: last 7 days, newest first) and click **Start**.
4. Export to Excel/CSV/JSON, or schedule daily runs with a webhook, Make, Zapier or n8n.

### What you get

| Field | Real example (award, 19 Nov 2026) |
|---|---|
| `source`, `noticeId`, `noticeUrl` | `Find a Tender service (FTS)`, `109737-2026`, link |
| `stage`, `publishedDate`, `title` | `award`, `2026-11-19`, `Employee Mileage and Expenses Reimbursement System` |
| `buyerName`, `buyerContactName`, `buyerEmail`, `buyerPostCode` | `Gloucestershire County Council`, `Jo Oakhill`, `…@gloucestershire.gov.uk`, `GL1 2TG` |
| `mainCpv`, `cpvCodes`, `category`, `deliveryRegions` | `48000000`, `["48000000"]`, `goods`, `["UKK13"]` |
| `value`, `currency`, `tenderDeadline` | open tenders: e.g. `250000` `GBP`, `2026-12-11T12:00:00Z` |
| `awardedValue`, `awardDate`, `contractStart`, `contractEnd` | `112383.94`, `2026-10-30`, `2026-11-01`, `2028-03-31` |
| `suppliers` | `[{name: "Concur Holdings (Netherlands) B.V.", companyNumber, identifier, address, postCode, country, email, website, scale: "large"}]` |
| `supplierCompanyNumbers` | e.g. `["07790198"]` (Arbor Education Partners, East Sussex schools MIS, £900k) |
| `suitableForSme`, `suitableForVcse` | `true` / `false` |

Three table views are included: **Overview**, **Open tenders** and **Awards & suppliers**.

### Input examples

**Open software and IT tenders, last 14 days:**

```json
{ "mode": "open", "cpvCodes": ["72", "48"], "daysBack": 14 }
```

**NHS contract winners with Companies House numbers (lead list):**

```json
{ "mode": "awards", "buyerKeywords": ["NHS"], "onlyWithCompanyNumber": true, "daysBack": 30, "maxItems": 1000 }
```

**Cleaning and facilities tenders in London worth at least £100k:**

```json
{ "mode": "open", "keywords": ["cleaning", "facilities management"], "regionCodes": ["UKI"], "minValue": 100000 }
```

**Scottish construction awards in October 2026:**

```json
{ "mode": "awards", "cpvCodes": ["45"], "regionCodes": ["UKM"], "publishedFrom": "2026-10-01", "publishedTo": "2026-10-31" }
```

**From Python:**

```python
from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("stimulating_stilbite/uk-public-tenders-contracts-finder").call(run_input={"mode": "open", "keywords": ["software"]})
for n in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(n["tenderDeadline"], n["buyerName"], n["title"], n["buyerEmail"])
```

### More official-data actors

💡 **Tender winners + company financials/contacts = qualified B2B leads.** A company that just won a public contract is growing, hiring and buying. Pass the winners' org numbers to the company actors below to add revenue, profit, employees, website, e-mail and phone — each of them also builds lead lists by industry and region in 3 clicks.

- 🇪🇺 [EU Public Tenders & Contract Winners (TED)](https://apify.com/stimulating_stilbite/eu-public-tenders-ted): every EU/EEA tender and award, with supplier e-mails and VAT/org numbers.
- 🇸🇪 [Swedish](https://apify.com/stimulating_stilbite/swedish-company-data-financials), 🇳🇴 [Norwegian](https://apify.com/stimulating_stilbite/norwegian-company-data-financials), 🇫🇮 [Finnish](https://apify.com/stimulating_stilbite/finnish-company-data-financials) and 🇫🇷 [French](https://apify.com/stimulating_stilbite/french-company-data-financials) company data with revenue, profit and website/e-mail/phone, plus lead lists by industry and region.

All actors: **[Nordic Data Tools on Apify](https://apify.com/stimulating_stilbite)**.

### FAQ

**What's the difference between Find a Tender and Contracts Finder?**\
Since the Procurement Act 2023 took effect in February 2025, Find a Tender is the central platform for UK public procurement notices. Contracts Finder still carries lower-value contracts in England. This actor searches both and removes duplicates that appear on both.

**Is there an official API? Do I need a key?**\
Yes, both services publish free OCDS APIs. This actor uses them without a key or account.

**How do keyword and CPV filters work?**\
Keywords match the title and description (case-insensitive, any keyword). CPV filters match any code in the notice, sub-codes included, so `72` covers all IT services.

**Why do some awards have no value or company number?**\
Buyers don't always publish them. Turn on *Only awards with a supplier Companies House number* to get lead-ready rows only.

**Can I use the contacts for outreach?**\
Contacts are published by the buyers under the Open Government Licence. If you use them for marketing, follow UK GDPR and PECR: B2B relevance, a legitimate-interest assessment and an easy opt-out.

**How fresh is it?**\
Notices appear within minutes of publication. Schedule `daysBack: 1` every morning for a daily alert.

**What does it cost?**\
Pay-per-event pricing is planned at about **$0.002 per notice** and **$0.003 per award with suppliers**, plus a small run start fee. Error items are always free. See the Pricing tab for the current price.

**Missing something?**\
Open an issue on the Issues tab.

### Data sources and licence

- **Find a Tender service** OCDS API (Cabinet Office), Open Government Licence v3.0.
- **Contracts Finder** OCDS API (Crown Commercial Service / Cabinet Office), Open Government Licence v3.0.
  Contains public sector information licensed under the Open Government Licence v3.0.

This actor isn't affiliated with the Cabinet Office, Crown Commercial Service or GOV.UK.

# Actor input Schema

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

<b>open</b> = tenders you can bid on; <b>awards</b> = contract awards with suppliers; <b>planned</b> = pipeline / preliminary market engagement notices; <b>all</b> = every notice.

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

Matched in the title or description (any of them, case-insensitive), e.g. "software", "cyber", "cleaning".

## `cpvCodes` (type: `array`):

CPV codes or prefixes: 72 = IT services, 48 = software, 45 = construction, 79 = business services, 85 = health & social, 90 = cleaning & environmental. Sub-codes included.

## `buyerKeywords` (type: `array`):

Keep notices whose buyer name contains any of these, e.g. "NHS", "council", "university", "Ministry of Defence".

## `regionCodes` (type: `array`):

Prefixes of delivery-region codes: UKI = London, UKJ = South East, UKD = North West, UKM = Scotland, UKL = Wales, UKN = Northern Ireland, UKG = West Midlands.

## `postcodePrefixes` (type: `array`):

e.g. "M" (Manchester), "EH" (Edinburgh), "SW1".

## `daysBack` (type: `integer`):

Ignored when 'Published from' is set. Newest day is fetched first.

## `publishedFrom` (type: `string`):

YYYY-MM-DD.

## `publishedTo` (type: `string`):

YYYY-MM-DD (inclusive). Default: today.

## `minValue` (type: `integer`):

Minimum estimated or awarded value. Notices without a value are excluded when set.

## `onlyOpenDeadlines` (type: `boolean`):

In 'open' mode, keep only tenders whose deadline is still in the future.

## `onlySmeSuitable` (type: `boolean`):

Keep only tenders the buyer marked as suitable for small and medium-sized enterprises.

## `onlyWithCompanyNumber` (type: `boolean`):

Lead-list mode: every row has at least one UK company number you can enrich.

## `sources` (type: `array`):

findATender and/or contractsFinder.

## `enrichFtsRecords` (type: `boolean`):

Find a Tender publishes updates as partial releases. When on, the full compiled record is fetched so CPV codes, values and suppliers are filled in.

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

Maximum notices to return (newest day first).

## Actor input object example

```json
{
  "mode": "all",
  "keywords": [
    "software",
    "cyber security"
  ],
  "cpvCodes": [
    "72",
    "48"
  ],
  "daysBack": 7,
  "onlyOpenDeadlines": true,
  "onlySmeSuitable": false,
  "onlyWithCompanyNumber": false,
  "sources": [
    "findATender",
    "contractsFinder"
  ],
  "enrichFtsRecords": true,
  "maxItems": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

All notices (table).

## `openTenders` (type: `string`):

Deadlines and buyer contacts.

## `awards` (type: `string`):

Winners with company numbers.

## `allData` (type: `string`):

Full 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 = {
    "mode": "all",
    "daysBack": 7,
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("stimulating_stilbite/uk-public-tenders-contracts-finder").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 = {
    "mode": "all",
    "daysBack": 7,
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("stimulating_stilbite/uk-public-tenders-contracts-finder").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 '{
  "mode": "all",
  "daysBack": 7,
  "maxItems": 50
}' |
apify call stimulating_stilbite/uk-public-tenders-contracts-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,stimulating_stilbite/uk-public-tenders-contracts-finder"
        }
    }
}
```

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/TP8bmyBnNpQhcFnE2/builds/VMPvdsjqql4U7sCDK/openapi.json
