# EU Public Tenders & Contract Winners (TED) – Leads API (`stimulating_stilbite/eu-public-tenders-ted`) Actor

Search EU public tenders and contract awards on TED by keyword, CPV, country and date. Get open tenders with buyer e-mails and deadlines, plus winning suppliers with org numbers and e-mails. Official API, no scraping.

- **URL**: https://apify.com/stimulating_stilbite/eu-public-tenders-ted.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

## EU Public Tenders & Contract Winners API (TED) – Tender Leads, No Scraping

Search **every EU/EEA public procurement notice on TED (Tenders Electronic Daily)** by **keyword, CPV code, buyer country, date and value**, and get clean JSON/CSV/Excel:

- **Open tenders to bid on**: title, description, buyer name, **buyer e-mail and phone**, deadline, estimated value, submission and document links.
- **Contract awards as B2B leads**: who won, awarded value, and every **supplier organisation named in the notice with company number (org nr / VAT), e-mail, phone, city and size**. These are companies that sell to the public sector right now.
- **Planned tenders** (prior information notices), so you hear about deals months before the call.

Built on the **official TED Search API v3** of the Publications Office of the European Union. No scraping of ted.europa.eu, no proxies, no captchas, no API key, and TED's reuse policy allows commercial use.

👉 Click **Try for free**. The form is prefilled with Nordic IT tenders from the last 14 days.

### Who uses this

- **Bid and tender teams**: a daily feed of new calls in your CPV codes and countries, with deadlines, sent to Sheets, Slack or your CRM.
- **B2B sales and lead generation**: suppliers that just won a public contract (they are hiring, buying and subcontracting) with e-mails and company IDs.
- **Market intelligence**: who wins what, at what value, from which buyers. Competitor tracking by supplier ID.
- **Consultants and AI agents**: structured procurement data with no HTML parsing.

### How to get started

1. Pick **What to find**: *Open tenders*, *Contract awards & winners*, *Planned tenders* or *All*.
2. Add **CPV codes** (e.g. `72` IT services, `48` software, `45` construction, `79` business services, `33` medical) and/or **keywords**.
3. Choose **buyer countries** (`SE`, `FI`, `NO`, `DK`, `DE`, `FR`, … or leave empty for all of the EU/EEA) and a date range.
4. Click **Start**. Download as Excel/CSV/JSON, or schedule it daily and push to Make, Zapier, n8n or a webhook.

### What you get

| Field | Real example (contract award, Sweden, 19 Nov 2026) |
|---|---|
| `publicationNumber`, `noticeTypeLabel`, `publicationDate` | `804020-2026`, `Contract award notice`, `2026-11-19` |
| `title`, `titleEnglish` | `Skanning- VAN och Printtjänster`, `Sweden – Scanning and invoicing services – …` |
| `buyerName`, `buyerEmail`, `buyerPhone`, `buyerIdentifier` | `Region Uppsala`, `…@regionuppsala.se`, `+46 1 861 10 00 0`, `2321000024` |
| `mainCpv`, `cpvCodes`, `contractNature`, `procedureType` | `79999000`, `[79999000, 72400000, …]`, `services`, `open` |
| `estimatedValue`, `awardedValue` (+ currency) | `25200000`, `15000000` `SEK` |
| `winnerNames`, `winners` | `["GEP Sweden AB"]`, `[{name, identifier: "5591341705", email, city, country, size}]` |
| `tenderers` | all supplier organisations in the notice: name, org nr / VAT, e-mail, phone, city, postcode, country, website, size, `isWinner` |
| `supplierEmails`, `supplierIdentifiers` | unique lists for quick lead export |
| `tenderDeadline`, `submissionUrl`, `documentsUrl` | for open tenders, e.g. `2026-12-12`, `https://kommersannons.se/…` |
| `tedUrl`, `pdfUrl` | official notice page and PDF |

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

### Input examples

**Open IT and software tenders in the Nordics, still accepting bids:**

```json
{ "mode": "open", "cpvCodes": ["72", "48"], "countries": ["SE", "FI", "NO", "DK"], "daysBack": 30 }
```

**Contract winners with e-mails in Sweden, last 30 days (lead list):**

```json
{ "mode": "awards", "countries": ["SE"], "daysBack": 30, "onlyWithSupplierEmail": true, "maxItems": 1000 }
```

**Cybersecurity tenders across the EU worth at least 1 million:**

```json
{ "mode": "open", "keywords": ["cybersecurity", "cyber security", "SOC"], "minValue": 1000000 }
```

**Construction awards in Germany and Austria in Q3 2026:**

```json
{ "mode": "awards", "cpvCodes": ["45"], "countries": ["DE", "AT"], "publishedFrom": "2026-07-01", "publishedTo": "2026-09-30" }
```

**Advanced (TED expert query):**

```json
{ "mode": "open", "countries": ["FR"], "expertQuery": "buyer-legal-type IN (cga) AND procedure-type=open" }
```

**From Python:**

```python
from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("stimulating_stilbite/eu-public-tenders-ted").call(run_input={"mode": "awards", "countries": ["SE"], "daysBack": 7})
for n in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(n["publicationDate"], n["buyerName"], n["winnerNames"], n["supplierEmails"])
```

### Turn winners into enriched leads

💡 **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.
Supplier IDs are national company numbers or VAT numbers. Feed them straight into our official-data company actors for **revenue, profit, industry, directors, website, e-mail and phone**:

- 🇸🇪 [Swedish Company Data & Financials](https://apify.com/stimulating_stilbite/swedish-company-data-financials) (org nr, e.g. `5591341705`)
- 🇳🇴 [Norwegian Company Data & Financials](https://apify.com/stimulating_stilbite/norwegian-company-data-financials)
- 🇫🇮 [Finnish Company Data & Financials](https://apify.com/stimulating_stilbite/finnish-company-data-financials)
- 🇫🇷 [French Company Data & Financials](https://apify.com/stimulating_stilbite/french-company-data-financials)
- 🇬🇧 [UK Public Tenders & Contract Awards](https://apify.com/stimulating_stilbite/uk-public-tenders-contracts-finder) (Contracts Finder)

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

### FAQ

**What is TED?**\
TED (Tenders Electronic Daily) is the online Supplement to the Official Journal of the EU. Public buyers in the EU, the EEA and some other countries must publish tenders above the EU thresholds there. That's roughly 750,000 notices a year: calls for tender, prior information and contract awards.

**Is there a TED API? Do I need an API key?**\
Yes. This actor uses the official TED Search API v3 anonymously, so you don't need a key or an EU Login account.

**How do I search by CPV code?**\
Enter a full 8-digit code (`72000000`) or a prefix (`72`, `7222`). Sub-codes are included automatically, so `72` covers all IT services.

**Why do keywords miss some notices?**\
Notices are written in the buyer's language. Add local words (e.g. `programvara`, `ohjelmisto`, `Software`) or use CPV codes, which work in every language.

**Who are the "tenderers" in an award notice?**\
They are the supplier organisations TED publishes for the awarded lots. `winnerNames` is TED's own winner field. `isWinner` is `true` when a supplier matches it and `null` when TED doesn't say, for example on multi-supplier framework agreements.

**Can I use the e-mails for outreach?**\
Contacts are published by the contracting authorities in the EU Official Journal. Many are company functional addresses, but some name a person. If you contact EU residents you are responsible for GDPR and e-marketing rules: use a legitimate-interest basis, B2B relevance and an easy opt-out.

**How fresh is the data?**\
TED publishes every working day (Monday to Friday). Schedule the actor daily with `daysBack: 1` or `2`.

**How many results can I get?**\
Up to 20,000 notices per run, newest first. Split bigger pulls by date range.

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

**Something missing?**\
Open an issue on the Issues tab, and we usually ship fixes within days.

### Data source and licence

- **TED – Tenders Electronic Daily**, Publications Office of the European Union, Search API v3 (api.ted.europa.eu). TED data is reusable free of charge, including for commercial purposes, under the Publications Office's reuse policy (Commission Decision 2011/833/EU). Source: © European Union, https://ted.europa.eu.

This actor isn't affiliated with the Publications Office of the EU or the European Commission.

# Actor input Schema

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

<b>open</b> = calls for tender you can still bid on (contract notices); <b>awards</b> = contract award notices with winning/tendering suppliers; <b>planned</b> = prior information notices (upcoming tenders); <b>all</b> = every notice type.

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

Words or phrases matched anywhere in the notice (OR). Notices are in the buyer's language, so add local words too (e.g. "software", "programvara", "ohjelmisto"). For language-independent search use CPV codes.

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

Common Procurement Vocabulary codes or prefixes. 72 or 72000000 = all IT services, 48 = software packages, 45 = construction, 79 = business services, 33 = medical equipment. Sub-codes are included automatically.

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

ISO country codes of the contracting authority (SE, FI, NO, DK, DE, FR, … or SWE, FIN, …). Empty = all EU/EEA.

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

Ignored when 'Published from' is set.

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

YYYY-MM-DD. Overrides 'last N days'.

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

YYYY-MM-DD (inclusive).

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

In 'open' mode, keep only notices whose tender or request-to-participate deadline is today or later.

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

Minimum estimated or awarded value in the notice's own currency (EUR, SEK, PLN, …). Notices without a published value are excluded when set.

## `onlyWithSupplierEmail` (type: `boolean`):

Keep only award notices that publish at least one supplier e-mail (lead-list mode).

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

Titles/descriptions are returned in this language when the buyer published it, otherwise in the original language. 'titleEnglish' is always the official English summary title.

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

Newest first. Up to 20,000 per run.

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

Overrides 'What to find'. eForms codes, e.g. cn-standard, can-standard, can-modif, pin-only, veat.

## `expertQuery` (type: `string`):

Extra clause in TED expert-search syntax, ANDed with the filters, e.g. <code>buyer-legal-type IN (cga)</code> or <code>procedure-type=open</code>.

## Actor input object example

```json
{
  "mode": "all",
  "keywords": [
    "cloud",
    "cybersecurity"
  ],
  "cpvCodes": [
    "72",
    "48000000"
  ],
  "countries": [
    "SE",
    "FI",
    "NO",
    "DK"
  ],
  "daysBack": 14,
  "onlyOpenDeadlines": true,
  "onlyWithSupplierEmail": false,
  "language": "en",
  "maxItems": 20
}
```

# Actor output Schema

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

All notices (table).

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

Deadlines, buyer contacts, values.

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

Winners and supplier contacts.

## `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",
    "cpvCodes": [
        "72"
    ],
    "countries": [
        "SE",
        "FI",
        "NO",
        "DK"
    ],
    "daysBack": 14,
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stimulating_stilbite/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 = {
    "mode": "all",
    "cpvCodes": ["72"],
    "countries": [
        "SE",
        "FI",
        "NO",
        "DK",
    ],
    "daysBack": 14,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stimulating_stilbite/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 '{
  "mode": "all",
  "cpvCodes": [
    "72"
  ],
  "countries": [
    "SE",
    "FI",
    "NO",
    "DK"
  ],
  "daysBack": 14,
  "maxItems": 20
}' |
apify call stimulating_stilbite/eu-public-tenders-ted --silent --output-dataset

```

## MCP server setup

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