# EU & UK Public Tenders Scraper: TED + UK Find a Tender (`michael80/eu-public-tenders-ted`) Actor

EU and UK tenders and public procurement scraper: open government contracts from TED (all of Europe, incl. German Ausschreibungen) and UK Find a Tender, with deadline, days left, value, duration, award criteria, CPV in English and links.

- **URL**: https://apify.com/michael80/eu-public-tenders-ted.md
- **Developed by:** [Toolmaster Data Tools](https://apify.com/michael80) (community)
- **Categories:** Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.40 / 1,000 tender founds

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

## EU & UK Public Tenders Scraper (TED + Find a Tender): Open Calls, Deadline & Value

Find **open public tenders from all over Europe, including the United Kingdom,** in one clean table. The Actor uses two official government sources: the **search API of TED (Tenders Electronic Daily)**, the EU's official journal for public procurement with notices from the EU, EEA and partner countries, and the **UK government's Find a Tender service** (UK tenders are no longer on TED since Brexit).

- **One flat, CSV-ready row per tender** with what bid teams actually need: **submission deadline and days left**, estimated value and currency, contract duration in months, number of lots, **award criteria** (lowest price vs. price and quality), SME suitability, framework agreement, buyer, country, city, NUTS region, procedure type.
- **English category for every tender:** the official **English CPV label** (e.g. *Software package and information systems*) next to the original title, so you can scan tenders from 30+ countries at a glance.
- **Powerful filters:** full-text keywords in any language, buyer countries (`DE`, `FR`, `AT` …), CPV codes or prefixes (sub-categories included automatically), minimum value, only open calls, publication window.
- **Early warning:** optionally include **prior information notices**, where buyers announce purchases months before the call.
- **Daily alerts without duplicates:** with *Only new tenders* the Actor remembers what it delivered and returns only new notices. Known ones are skipped and **free**.
- **Direct links:** TED page and PDF in your language, procurement documents and e-submission platform.

### Who uses it

| User | Typical use |
| --- | --- |
| Bid and sales teams | Daily list of new tenders in their CPV codes and countries |
| Consultants and tender services | Monitor several sectors and countries for clients |
| Market analysts | Measure public demand by sector, country and value |

### Input

| Field | Example | Notes |
| --- | --- | --- |
| `keywords` | `["software", "Photovoltaik"]` | Optional; each line is a separate full-text search, results are merged |
| `countries` | `["DE", "AT", "UK"]` | Buyer country, 2 or 3 letters; empty = all (incl. UK) |
| `includeUk` | `true` | Also search UK Find a Tender |
| `countries: ["US"]`, `samGovApiKey`, `naicsCodes` | `["DE", "US"]`, your key, `["5415"]` | Optional: US federal tenders from SAM.gov |
| `cpvCodes` | `["72", "48000000"]` | Optional; prefixes and sub-categories included |
| `publishedWithinDays` | `7` | 1 to 365 |
| `onlyOpen` | `true` | Skips calls whose deadline has passed |
| `minEstimatedValue` | `100000` | Optional |
| `includePriorInformation` | `false` | Adds announcements of upcoming tenders |
| `onlyNew`, `monitorName` | `true`, `"it-dach"` | For scheduled daily runs |
| `linkLanguage` | `en` | Language of TED page and PDF links |
| `maxResults` | `500` | |

### Output (one row per tender)

| Field | Example |
| --- | --- |
| `noticeId`, `publicationDate`, `noticeType` | `767570-2026`, `2026-11-05`, `call for competition` |
| `title`, `cpvLabel`, `mainCpv`, `cpvCodes` | original title, `Insurance services`, `66510000` |
| `buyerName`, `buyerType`, `buyerCountry`, `buyerCity` | `VILLE DE GERZAT`, `la` (local authority), `FRA`, `Gerzat` |
| `placeOfPerformance`, `performanceCities` | `FRK14`, `Gerzat` |
| `deadline`, `deadlineType`, `daysLeft` | `2026-11-27`, `tenders` (or `requests to participate` in two-stage procedures), `14` |
| `estimatedValue`, `currency`, `durationMonths`, `lots` | `400000`, `EUR`, `48`, `5` |
| `awardCriteria`, `smeSuitable`, `frameworkAgreement`, `contractNature`, `procedureType` | `price and quality`, `true`, `false`, `services`, `open` |
| `description` | first 1,500 characters |
| `source`, `noticeUrl`, `pdfUrl`, `documentsUrl`, `submissionUrl` | `TED` or `UK Find a Tender`, direct links |

### Pricing (pay per event)

**$3 per 1,000 tenders** delivered ($0.003 each). Searches that fail, tenders filtered out and tenders skipped by *Only new tenders* are free. A daily alert with 30 new tenders costs about $0.09 per day.

### Scope

The Actor covers calls for competition (and optionally prior information notices) published on TED, and open tender notices from UK Find a Tender. It does not include contract award notices. **Building cleaning, caretaker, winter service and grounds maintenance tenders (CPV 909…, 9061–9064…, 7731–7732…, 983411…, 79993…) are outside the scope of this Actor and are not returned.** National below-threshold tenders that are only published on national portals are not part of TED.

**US federal tenders (optional):** add `US` to the buyer countries and enter your free SAM.gov key (sam.gov › Account Details › Public API Key). The Actor then also returns open solicitations from SAM.gov in the same table, with NAICS and PSC codes, set-aside (small business) and response deadline. Personal SAM.gov keys allow about 10 searches per day (one per keyword). Janitorial and building services (NAICS 5617…) are out of scope here as well.

Sources: TED, © European Union, reused under Commission Decision 2011/833/EU. UK Find a Tender: contains public sector information licensed under the Open Government Licence v3.0. SAM.gov: US government work, public domain. The Actor does not output contact persons or email addresses, and no contract award winners.

### FAQ

**Why is the estimated value empty?** Buyers are not obliged to publish it; many do not.

**Can I combine keywords?** Each line is searched separately and duplicates are removed. Use a phrase such as `"cloud migration"` for an exact phrase.

**Something wrong or missing?** Open an issue on the Actor page. We usually answer within one business day.

***

### Kurz auf Deutsch

Offene öffentliche Ausschreibungen aus ganz Europa **inklusive Großbritannien** über die **offiziellen Schnittstellen von TED und UK Find a Tender**: eine CSV-taugliche Zeile je Ausschreibung mit **Frist und Resttagen**, geschätztem Wert, Laufzeit, Losen, **Zuschlagskriterien**, Auftraggeber, Region und direkten Links. Filter nach Stichwort, Land, CPV und Mindestwert, optional **Vorinformationen** (Frühwarnung) und **nur neue Ausschreibungen** für den täglichen Abruf. Gebäudereinigung, Hausmeister-, Winter- und Grünflächendienste sind nicht enthalten. 3 $ pro 1.000 Ausschreibungen.

***

**Anbieter / Impressum (Angaben gemäß § 5 DDG):** Michael Schönherr · Am Spiegelwald 1 · 08344 Grünhain-Beierfeld · Deutschland · E-Mail: toolmaster@tuta.io

# Changelog

This Actor's version history is a separate document: https://apify.com/michael80/eu-public-tenders-ted/changelog.md

# Actor input Schema

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

Optional full-text search, one keyword or phrase per line (any language, e.g. 'software', 'Photovoltaik', 'medical devices'). Each line is a separate search; results are merged without duplicates. Leave empty to get all tenders that match the other filters.

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

Optional country codes of the contracting authority, two or three letters (e.g. 'DE', 'FR', 'AT', 'UK', 'US'). Covers EU, EEA and other countries publishing on TED, the United Kingdom via Find a Tender and, if you add 'US', US federal tenders via SAM.gov (needs a free SAM.gov key). Leave empty for all of Europe incl. UK.

## `includeUk` (type: `boolean`):

Also searches the UK government's official Find a Tender service (UK tenders are no longer published on TED since Brexit). Used when 'Buyer countries' is empty or contains UK/GB.

## `samGovApiKey` (type: `string`):

Free key from sam.gov (sign in > Account Details > Public API Key). Only needed when 'Buyer countries' contains US. Personal keys allow about 10 searches per day: one search per keyword. Stored encrypted.

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

Optional CPV codes or prefixes, e.g. '72' (IT services), '45' (construction work), '33100000' (medical equipment). Sub-categories are included automatically.

## `naicsCodes` (type: `array`):

Optional for US tenders: NAICS industry codes or prefixes, e.g. 541511 (custom software) or 5415. CPV codes do not exist in the US.

## `publishedWithinDays` (type: `integer`):

Only notices published in the last N days.

## `onlyOpen` (type: `boolean`):

Skips calls whose submission deadline has already passed. Notices without a deadline (e.g. prior information) are kept.

## `minEstimatedValue` (type: `integer`):

Optional. Only tenders with an estimated contract value of at least this amount (in the notice currency, usually EUR). Tenders without a published value are skipped when this is set.

## `includePriorInformation` (type: `boolean`):

Also returns prior information notices: buyers announce upcoming purchases months before the actual call. Gives you a head start.

## `onlyNew` (type: `boolean`):

Remembers tenders delivered by earlier runs with the same filters and returns only new ones (known ones are skipped and free). Ideal for a daily schedule.

## `monitorName` (type: `string`):

Optional name of the storage that remembers delivered tenders (only with 'Only new tenders'). Use different names for different monitors; default 'eu-tenders-monitor'.

## `linkLanguage` (type: `string`):

Language of the TED web page and PDF links in the results.

## `maxResults` (type: `integer`):

Stops after this many tenders (all keywords together).

## `selfTest` (type: `boolean`):

Runs one small fixed search (Germany, last 7 days, 5 tenders) to check that everything works. Ignores the other fields.

## Actor input object example

```json
{
  "keywords": [
    "software"
  ],
  "countries": [
    "DE",
    "AT"
  ],
  "includeUk": true,
  "publishedWithinDays": 7,
  "onlyOpen": true,
  "includePriorInformation": false,
  "onlyNew": false,
  "linkLanguage": "en",
  "maxResults": 20,
  "selfTest": false
}
```

# Actor output Schema

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

Deadline, buyer, category, value and link per tender.

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

Complete rows incl. CPV codes, NUTS regions, procedure type, documents and submission links.

# 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": [
        "software"
    ],
    "countries": [
        "DE",
        "AT"
    ],
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("michael80/eu-public-tenders-ted").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": ["software"],
    "countries": [
        "DE",
        "AT",
    ],
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("michael80/eu-public-tenders-ted").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": [
    "software"
  ],
  "countries": [
    "DE",
    "AT"
  ],
  "maxResults": 20
}' |
apify call michael80/eu-public-tenders-ted --silent --output-dataset

```

## MCP server setup

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

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/GClrhSCPyYDQCODlh/builds/tKsybQ79hZS7ddRVI/openapi.json
