# UK Public Tenders: Find a Tender & Contracts Finder (`flets_sv/uk-public-tenders`) Actor

Get UK public procurement notices from Find a Tender and Contracts Finder (official OCDS APIs): tenders, awards, buyers, values, CPV codes and deadlines.

- **URL**: https://apify.com/flets_sv/uk-public-tenders.md
- **Developed by:** [FlEtsv](https://apify.com/flets_sv) (community)
- **Categories:** Lead generation, Business
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 tender notice returneds

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 Scraper

Licitaciones publicas del Reino Unido de Find a Tender y Contracts Finder (OCDS oficial), en datos estructurados. / UK public procurement notices from Find a Tender and Contracts Finder (official OCDS), as structured data.

*Version en espanol mas abajo.*

### English

#### What does it do?

It reads public procurement notices from [Find a Tender](https://www.find-tender.service.gov.uk) and [Contracts Finder](https://www.contractsfinder.service.gov.uk) through their official OCDS APIs. It normalizes tenders, awards, buyers, values, CPV codes and deadlines into one schema, merges the same notice found on both portals, and stores one dataset item per notice.

#### Use cases

- Build a daily list of new public tenders for a sales team.
- Filter opportunities by CPV prefix, region, keyword, stage or minimum value.
- Track submission deadlines so you do not miss a bid.
- Feed a CRM or a spreadsheet with normalized procurement data.
- Get alerts for new or changed notices with monitor mode and a schedule.

#### Input

| Field | Type | Description |
| --- | --- | --- |
| `fuentes` | array | Sources to query: `fts` (Find a Tender) and/or `cf` (Contracts Finder). Default: both. |
| `fases` | array | Stages to keep: `planning`, `tender`, `award`. Empty means tender and award. |
| `palabrasClave` | array | Keywords matched in the title or description (any of them). Optional. |
| `cpv` | array | CPV prefixes, for example `72` (IT services) or `45` (construction). Optional. |
| `valorMinimo` | integer | Skip notices whose estimated value is below this amount (GBP). Default `0`. |
| `region` | string | Region or postcode prefix, for example `London`, `Scotland` or `M`. Optional. |
| `desdeFecha` | string | Published since, `YYYY-MM-DD`. Default: the last 2 days. |
| `modoVigilancia` | boolean | Remember notices seen in previous runs and output only new or changed ones. Default `false`. |
| `maxAvisos` | integer | Hard limit of notices per run, between 1 and 50000. Default `1000`. Protects your budget. |

All fields are optional, so an empty input runs with the defaults.

#### Output

One dataset item per notice:

```json
{
  "ocid": "ocds-h6vhtk-04a1b2",
  "idAviso": "000001-2026",
  "fuente": "fts",
  "fase": "tender",
  "titulo": "Cloud hosting framework",
  "descripcion": "Framework for cloud hosting services",
  "comprador": "Example Council",
  "region": "London",
  "cpv": ["72000000"],
  "valorEstimado": 450000,
  "moneda": "GBP",
  "fechaPublicacion": "2026-10-30T09:00:00Z",
  "fechaLimite": "2026-11-30T12:00:00Z",
  "procedimiento": "open",
  "adjudicatarios": null,
  "valorAdjudicado": null,
  "url": "https://www.find-tender.service.gov.uk/Notice/000001-2026",
  "licencia": "OGL-UK-3.0"
}
```

`fuente` is `fts`, `cf` or `ambas` when the same notice came from both portals.

#### Pricing

- Event `tender-notice`: 0.002 USD per notice returned in the dataset.
- The run never charges more than `maxAvisos` notices, and it stops early if the spending limit is reached.

#### Monitor mode

With `modoVigilancia` set to `true`, the Actor keeps a key-value store (`uk-public-tenders-vigilancia`) with a fingerprint of every notice it has delivered. Later runs output only notices that are new or whose deadline, value, buyer or award changed. Only notices actually delivered are remembered, so a run cut short by the spending limit does not hide the rest. Combine it with the scheduler for alerts.

#### FAQ

**Does it need an API key?** No. It reads the public OCDS APIs of both portals.

**Can I run it on a schedule?** Yes. Enable monitor mode and use the scheduler to receive new notices every day.

**What if one portal is unavailable?** The run reports the error and keeps the notices from the other portal.

**Is the data normalized?** Yes. Dates, amounts, currencies and CPV codes use one schema.

### Español

#### ¿Qué hace?

Lee los anuncios de contratacion publica de [Find a Tender](https://www.find-tender.service.gov.uk) y [Contracts Finder](https://www.contractsfinder.service.gov.uk) a traves de sus APIs OCDS oficiales. Normaliza licitaciones, adjudicaciones, compradores, importes, codigos CPV y plazos en un unico esquema, unifica el mismo anuncio cuando aparece en los dos portales y guarda un elemento del dataset por anuncio.

#### Casos de uso

- Crear cada dia una lista de licitaciones nuevas para un equipo comercial.
- Filtrar oportunidades por prefijo CPV, region, palabra clave, fase o importe minimo.
- Seguir los plazos de presentacion para no perder una oferta.
- Alimentar un CRM o una hoja de calculo con datos de contratacion normalizados.
- Recibir avisos de anuncios nuevos o cambiados con el modo vigilancia y una programacion.

#### Entrada

| Campo | Tipo | Descripcion |
| --- | --- | --- |
| `fuentes` | array | Fuentes a consultar: `fts` (Find a Tender) y/o `cf` (Contracts Finder). Por defecto, ambas. |
| `fases` | array | Fases que se conservan: `planning`, `tender`, `award`. Vacio significa licitacion y adjudicacion. |
| `palabrasClave` | array | Palabras clave buscadas en el titulo o la descripcion (basta con una). Opcional. |
| `cpv` | array | Prefijos CPV, por ejemplo `72` (servicios de TI) o `45` (construccion). Opcional. |
| `valorMinimo` | integer | Omite los anuncios cuyo valor estimado es menor que este importe (GBP). Por defecto `0`. |
| `region` | string | Region o prefijo de codigo postal, por ejemplo `London`, `Scotland` o `M`. Opcional. |
| `desdeFecha` | string | Publicados desde, `AAAA-MM-DD`. Por defecto, los ultimos 2 dias. |
| `modoVigilancia` | boolean | Recuerda los anuncios de ejecuciones anteriores y entrega solo los nuevos o cambiados. Por defecto `false`. |
| `maxAvisos` | integer | Limite maximo de anuncios por ejecucion, entre 1 y 50000. Por defecto `1000`. Protege tu presupuesto. |

Todos los campos son opcionales, asi que una entrada vacia usa los valores por defecto.

#### Salida

Un elemento del dataset por anuncio:

```json
{
  "ocid": "ocds-h6vhtk-04a1b2",
  "idAviso": "000001-2026",
  "fuente": "fts",
  "fase": "tender",
  "titulo": "Cloud hosting framework",
  "descripcion": "Framework for cloud hosting services",
  "comprador": "Example Council",
  "region": "London",
  "cpv": ["72000000"],
  "valorEstimado": 450000,
  "moneda": "GBP",
  "fechaPublicacion": "2026-10-30T09:00:00Z",
  "fechaLimite": "2026-11-30T12:00:00Z",
  "procedimiento": "open",
  "adjudicatarios": null,
  "valorAdjudicado": null,
  "url": "https://www.find-tender.service.gov.uk/Notice/000001-2026",
  "licencia": "OGL-UK-3.0"
}
```

`fuente` es `fts`, `cf` o `ambas` cuando el mismo anuncio llego por los dos portales.

#### Precios

- Evento `tender-notice`: 0,002 USD por anuncio devuelto en el dataset.
- La ejecucion nunca cobra mas de `maxAvisos` anuncios y se detiene antes si se alcanza el tope de gasto.

#### Modo vigilancia

Con `modoVigilancia` en `true`, el Actor guarda en un almacen clave-valor (`uk-public-tenders-vigilancia`) una huella de cada anuncio entregado. Las ejecuciones siguientes solo sacan anuncios nuevos o cuyo plazo, valor, comprador o adjudicacion han cambiado. Solo se recuerdan los anuncios realmente entregados, asi que una ejecucion cortada por el tope de gasto no oculta el resto. Combinalo con el planificador para recibir avisos.

#### Preguntas frecuentes

**Necesita una clave de API?** No. Lee las APIs OCDS publicas de los dos portales.

**Se puede ejecutar de forma programada?** Si. Activa el modo vigilancia y usa el planificador para recibir anuncios nuevos cada dia.

**Que pasa si un portal no responde?** La ejecucion informa del error y conserva los anuncios del otro portal.

**Los datos estan normalizados?** Si. Fechas, importes, monedas y codigos CPV usan un unico esquema.

### Data source and license

Contains public sector information licensed under the Open Government Licence v3.0.
Source: [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/). The `licencia` field of every item is `OGL-UK-3.0`. Respect each portal's terms of use. This Actor only normalizes and filters publicly available notices.

### Datos y licencia

Contiene informacion del sector publico bajo la Open Government Licence v3.0 (OGL v3). Fuente: [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/). El campo `licencia` de cada elemento es `OGL-UK-3.0`. Respeta las condiciones de uso de cada portal. Este Actor solo normaliza y filtra anuncios publicos.

### Related Actors / Actores relacionados

Public tenders and grants family by Flets_sv / Familia de licitaciones y ayudas:

- [Spain tenders (PLACSP)](https://apify.com/flets_sv/licitaciones-placsp): Spanish national and regional public tenders.
- [Spain grants and subsidies (BDNS)](https://apify.com/flets_sv/subvenciones-bdns-espana): ayudas y subvenciones de España.
- [EU tenders (TED)](https://apify.com/flets_sv/ted-eu-tenders): above-threshold tenders of all EU countries.
- [France tenders (BOAMP)](https://apify.com/flets_sv/boamp-france-tenders): French marchés publics.
- [Australia government contracts (AusTender)](https://apify.com/flets_sv/austender-australia-contracts): federal contracts awarded.

# Actor input Schema

## `fuentes` (type: `array`):

`fts` (Find a Tender) and/or `cf` (Contracts Finder).

## `fases` (type: `array`):

`planning`, `tender`, `award`. Empty = tender + award.

## `palabrasClave` (type: `array`):

Match in title or description (any). Optional.

## `cpv` (type: `array`):

e.g. `72` (IT services), `45` (construction). Optional.

## `valorMinimo` (type: `integer`):

Skip notices below this estimated value.

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

e.g. `London`, `Scotland`, `M`. Optional.

## `desdeFecha` (type: `string`):

Default: last 2 days.

## `modoVigilancia` (type: `boolean`):

Remember what was seen in previous runs (key-value store) and output only new or changed notices. Use it with a schedule for alerts.

## `maxAvisos` (type: `integer`):

Hard limit of notices per run. Protects your budget.

## Actor input object example

```json
{
  "fuentes": [
    "fts",
    "cf"
  ],
  "fases": [],
  "palabrasClave": [],
  "cpv": [],
  "valorMinimo": 0,
  "region": "",
  "desdeFecha": "",
  "modoVigilancia": false,
  "maxAvisos": 20
}
```

# Actor output Schema

## `resultados` (type: `string`):

No description

# 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 = {
    "fuentes": [
        "fts",
        "cf"
    ],
    "desdeFecha": "",
    "maxAvisos": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("flets_sv/uk-public-tenders").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 = {
    "fuentes": [
        "fts",
        "cf",
    ],
    "desdeFecha": "",
    "maxAvisos": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("flets_sv/uk-public-tenders").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 '{
  "fuentes": [
    "fts",
    "cf"
  ],
  "desdeFecha": "",
  "maxAvisos": 20
}' |
apify call flets_sv/uk-public-tenders --silent --output-dataset

```

## MCP server setup

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

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/unKPZCKVa1xCzK7ML/builds/8xgyyP9KduiByGeDI/openapi.json