# Public Tender Alerts: EU and UK Procurement Notices (`tan-solutions/public-tenders`) Actor

New public tenders from the EU (TED) and the UK Find a Tender Service in one clean feed: deadline, CPV codes, buyer, value. Filter by CPV, country, keyword or buyer; the daily monitor returns only new notices. Pay per notice. Not affiliated with the EU or the UK Government.

- **URL**: https://apify.com/tan-solutions/public-tenders.md
- **Developed by:** [Tan Solutions](https://apify.com/tan-solutions) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 50.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 notice delivereds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Public Tender Alerts: EU and UK Procurement Notices

Get new public tenders from the whole EU and the UK in one clean feed. This Actor reads TED (Tenders Electronic Daily,
the EU's official journal of public procurement) and the UK Find a Tender Service through their open APIs, keeps the
notices that match your CPV codes, countries, keywords and buyers, and gives every notice the same fields: title,
buyer, country, CPV codes, deadline, estimated value and the link to the official notice. Run it daily and it returns
only the notices that are new since the last run.

### Run it from the API or on a schedule

Get this week's IT tenders from Germany, France and the UK in one call (replace the placeholder with your Apify token):

```bash
curl -X POST "https://api.apify.com/v2/acts/tan-solutions~public-tenders/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode": "full", "cpvCodes": ["72"], "countries": ["DE", "FR", "GB"], "lookbackDays": 7, "maxItems": 200}'
```

A run delivers at most 20 notices unless you say otherwise, so a first try costs cents. Set `maxItems` to get more,
as the example does with `"maxItems": 200` (up to 5,000). The limit is shared fairly between TED and Find a Tender,
and a monitor that stops at the limit carries on from there on its next run.

Get a daily alert at 07:00 Brussels time with an Apify schedule. Monitor mode with a fixed monitor name returns only
the notices that are new since the previous run:

```bash
curl -X POST "https://api.apify.com/v2/schedules?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name": "it-tenders-daily", "cronExpression": "0 7 * * *", "timezone": "Europe/Brussels", "isEnabled": true, "isExclusive": true,
       "actions": [{"type": "RUN_ACTOR", "actorId": "tan-solutions~public-tenders",
         "runInput": {"body": "{\"mode\": \"monitor\", \"monitorId\": \"it-tenders\", \"cpvCodes\": [\"72\"], \"countries\": [\"DE\", \"FR\", \"GB\"]}", "contentType": "application/json"}}]}'
```

In Apify Console the same is: **Schedules**, **Create new**, cron `0 7 * * *`, add this Actor with your input.

### What it does

- Reads new notices from TED (all EU and EEA countries) and the UK Find a Tender Service (FTS), 1 request per source at
  a time, 1 second between pages.
- Normalises both into one row shape: deadline, CPV codes, buyer name and country, estimated value and currency,
  procedure, number of lots, a short description and the official notice URL.
- Filters by CPV code (a short code matches the whole group), buyer country, keyword, buyer name, notice type and a
  minimum value.
- Monitor mode remembers which notices it has already sent you, per search (or per monitor name), and removes the same
  tender when it appears in both TED and FTS.
- Contact-person data is not returned: names, emails and phone numbers of contact persons are dropped.

### Who it is for

Suppliers, bid teams, bid-writing agencies and market analysts who want "new tenders that match my CPV codes,
keywords and countries since yesterday" in a spreadsheet, a CRM or a Slack channel, without checking two portals.

### Quick start

1. Click **Start** with the default input: this week's new open tenders from both sources.
2. Add your CPV codes (for example `72` for IT services or `45` for construction) and your countries.
3. Set a monitor name and add a daily schedule. Each run then delivers only the new notices.

### Input

| Field | What it does | Default |
| --- | --- | --- |
| Mode (`mode`) | `monitor`: only notices new since the last run of the same search. `full`: every match in the window. | `monitor` |
| Sources (`sources`) | `ted`, `uk-fts` | both |
| CPV codes (`cpvCodes`) | 2-8 digits; `72` matches every 72xxxxxx code | all |
| Buyer countries (`countries`) | ISO codes such as `DE`, `FR`, `GB` | all |
| Keywords (`keywords`) | Any of them in the title or description | all |
| Buyer names (`buyerNames`) | Any of them in the buyer name | all |
| Notice types (`noticeTypes`) | `tender`, `planning`, `award`, `other` | `tender` |
| Minimum estimated value (`minValue`) | In the notice's currency | none |
| Keep notices without a value (`includeMissingValue`) | Used with a minimum value | `true` |
| Published since (`publishedSince`) | A date such as `2026-11-01` | none |
| Look back (`lookbackDays`) | Window of the first run, 1-90 days | `7` |
| Max notices per run (`maxItems`) | Up to 5,000, shared fairly between the sources | `20` |
| Max pages per source (`maxPagesPerSource`) | 26 to 200 | `40` |
| Monitor name (`monitorId`) | Shares one memory of seen notices across runs | none |
| Language (`language`) | Two-letter code for TED titles | `en` |

### Output

One row per notice (a real row from a cloud run on 13 Nov 2026):

```json
{
  "status": "NOTICE",
  "isNew": true,
  "source": "ted",
  "noticeId": "752661-2026",
  "procedureId": "dc834cbc-91b6-4514-99d2-ec9a83183dc6",
  "url": "https://ted.europa.eu/en/notice/-/detail/752661-2026",
  "title": "Romania – Construction work for water and sewage pipelines – Proiectul regional de dezvoltare a infrastructurii de apă și apă uzată în județul Mureș, Lot 1 -3",
  "buyer": { "name": "COMPANIA AQUASERV S.A", "country": "RO" },
  "cpvCodes": ["45231300", "42961200", "45111291", "45232152", "45262210", "45262310", "71322000"],
  "procedure": "open",
  "noticeType": "tender",
  "noticeTypeRaw": "cn-standard",
  "publishedDate": "2026-10-30",
  "deadline": "2026-11-25",
  "estimatedValue": 75888633.01,
  "currency": "RON",
  "lotsCount": 3,
  "shortDescription": "Proiectare și execuție lucrări ”PROIECTUL REGIONAL DE DEZVOLTARE A INFRASTRUCTURII DE APĂ ȘI APĂ UZATĂ ÎN JUDEȚUL MUREȘ” Contractul de tip Proiectare si Execuție cuprinde atât proiectarea tehnologică și în detaliu precum și execuția construcțiilor civile, a instalațiilor mecanice, electrice și SCADA, inclusiv furnizarea si montarea echipamentelor aferente, pentru extinderea gospodariilor de apa, a conductelor de transport si a retelelor de distributie. Scopul lucrărilor include: • Proiectul Teh…",
  "dedupeKey": "ted:p:dc834cbc-91b6-4514-99d2-ec9a83183dc6:tender",
  "licence": "https://eur-lex.europa.eu/eli/dec/2011/833/oj",
  "attribution": "© European Union, https://ted.europa.eu",
  "error": null,
  "fetchedAt": "2026-11-13T21:15:56.673Z"
}
```

When nothing matches, the run returns one free row with `"status": "NO_MATCH"`. When a source fails after retries, the
run returns one free row with `"status": "ERROR"` and a code (`RATE_LIMITED`, `HTTP_ERROR` or `INTERNAL_ERROR`); the
other source still delivers. A run summary (pages read, duplicates removed, notices filtered out) is stored as
`SUMMARY` in the run's key-value store.

### Pricing

Pay per delivered notice (event `notice`). `NO_MATCH` and `ERROR` rows, filtered notices and duplicates are free.

| Plan | FREE | BRONZE | SILVER | GOLD | PLATINUM / DIAMOND |
| --- | --- | --- | --- | --- | --- |
| Per 1,000 notices | TODO-CEO | TODO-CEO | TODO-CEO | TODO-CEO | TODO-CEO |

### Limits

- At most 5,000 notices and 200 pages per source per run; the first run looks back at most 90 days.
- Monitor mode reads day by day. If one day has more notices than your page limit, the run reads it up to the limit,
  skips the rest of that day and says so in `SUMMARY.warnings`, so the monitor never gets stuck on one day.
- Values are as published by the buyer, in the notice's own currency; many notices publish no value.
- TED and FTS publish on working days, so a daily run on a Monday also covers the weekend.
- The same tender in TED and FTS is merged only when both carry the same reference; rare pairs can stay double.

### FAQ

**Why do I get fewer notices than on the portals?** The default notice type is `tender` (open calls you can bid on).
Add `planning`, `award` or `other` to get the rest.

**How does monitor mode know what is new?** It stores the IDs of the notices it delivered for this search (or this
monitor name) in your Apify account. Change the filters without a monitor name and it starts a new memory.

**Can I get the tender documents?** Each row links to the official notice, where the documents are listed.

### Related tools by Tan Solutions

- [UK Company Data](https://apify.com/tan-solutions/uk-companies): profiles, filings, charges and insolvency of the
  UK companies behind a buyer or a winning bidder.
- [US Company Filings & Financials](https://apify.com/tan-solutions/company-filings): 10-K, 10-Q, 8-K filings and XBRL
  financial facts of US public companies from SEC EDGAR.
- [Document to Markdown](https://apify.com/tan-solutions/document-to-markdown): tender PDFs, Word and PowerPoint files
  to Markdown for LLMs and bid tools.
- [URL to Markdown](https://apify.com/tan-solutions/url-to-markdown): turn any web page into clean Markdown for LLMs,
  RAG and AI agents.
- [Domain Intelligence](https://apify.com/tan-solutions/domain-intel): DNS, WHOIS/RDAP, SSL and tech stack of a
  company's website domain.

### Sources and attribution

- Contains information from TED (Tenders Electronic Daily), © European Union, https://ted.europa.eu
- Contains public sector information licensed under the Open Government Licence v3.0

Every row carries its own `licence` and `attribution`. Keep the attribution when you republish the data.

### Your responsibilities

- You are responsible for lawful use. Notice data stays under its source licence (the EU reuse policy for TED, the
  Open Government Licence v3.0 for FTS) and you keep the attribution when you republish it.
- Contact-person data is not returned.
- No warranty: notices can be amended, corrected or cancelled at the source; always check the official notice (URL in
  each row) before bidding. Deadlines are as published by the buyer. Liability is capped at the fees you paid in the
  last 12 months.
- Not affiliated with, endorsed by or sponsored by the European Union, the Publications Office of the European Union,
  the UK Cabinet Office or the Find a Tender Service.
- Questions and issues are answered within 14 days through the Actor's Issues tab.

Made by Tan Solutions.

# Actor input Schema

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

Monitor returns only notices that are new since the last run of the same search (use it on a schedule). Full returns every matching notice in the window, each time.

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

One per line: ted (EU, Tenders Electronic Daily) and/or uk-fts (UK Find a Tender Service). Empty = both.

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

One per line, 2 to 8 digits. A short code matches the whole group: 72 = all IT services, 4521 = building construction work. Empty = all.

## `countries` (type: `array`):

One per line, ISO codes such as DE, FR, GB (UK is accepted too). Empty = all.

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

One per line. A notice matches when its title or description contains any of them (case-insensitive). Empty = all.

## `buyerNames` (type: `array`):

One per line. A notice matches when the buyer name contains any of them, e.g. NHS or Stadt Berlin. Empty = all.

## `noticeTypes` (type: `array`):

One per line: tender (open calls you can bid on), planning (prior information), award (contract awards), other. Empty = tender only.

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

Only notices with an estimated value at or above this amount, in the notice's own currency. Empty = no minimum.

## `includeMissingValue` (type: `boolean`):

With a minimum value set: also keep notices that publish no estimated value (many do not).

## `publishedSince` (type: `string`):

Optional start date such as 2026-11-01. Empty = the look-back window below (or, in monitor mode, since the last run).

## `lookbackDays` (type: `integer`):

How far back the first run looks. Later monitor runs continue from the last run.

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

The run stops cleanly after this many delivered (paid) notices; a monitor continues where it stopped on the next run. Shared fairly between the sources. Default 20 keeps a first try at cents; raise it for bigger runs. Hard limit 5,000.

## `maxPagesPerSource` (type: `integer`):

Pages per source per run, read 1 second apart. A TED page holds up to 250 notices, a Find a Tender page up to 100. The minimum of 26 makes sure one whole TED publication day (usually about 3,500 notices) fits in one run. Hard limit 200.

## `monitorId` (type: `string`):

Optional: 1-40 letters, digits, - or \_. Runs with the same name share one memory of seen notices, even if you change the filters.

## `language` (type: `string`):

Two-letter EU language code for TED titles and descriptions (en, de, fr ...). English falls back to the original language when no translation exists.

## Actor input object example

```json
{
  "mode": "monitor",
  "sources": [
    "ted",
    "uk-fts"
  ],
  "noticeTypes": [
    "tender"
  ],
  "includeMissingValue": true,
  "lookbackDays": 1,
  "maxItems": 20,
  "maxPagesPerSource": 40,
  "language": "en"
}
```

# Actor output Schema

## `results` (type: `string`):

One item per tender notice: title, buyer, country, CPV codes, deadline, estimated value, notice type and the link to the official notice.

# 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 = {
    "lookbackDays": 1,
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("tan-solutions/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 = {
    "lookbackDays": 1,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("tan-solutions/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 '{
  "lookbackDays": 1,
  "maxItems": 20
}' |
apify call tan-solutions/public-tenders --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tan-solutions/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/eEefRr8tab1uHnPdU/builds/GVZU7zqfiNGig6PBN/openapi.json
