# TED Scraper – EU Public Tenders & Contract Awards Finder (`dedicated_crest/ted-eu-tenders-finder`) Actor

Search EU public tenders on TED (Tenders Electronic Daily) by keyword, CPV code and country via the official TED API. Deadlines, buyer, estimated value, documents link, plus contract award winners. Daily bid alerts. $2/1,000.

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

## Pricing

$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

## TED Scraper – EU Public Tenders & Contract Awards Finder

Search public tenders from all EU countries (plus Norway, Switzerland, Iceland and more) on TED, Tenders Electronic Daily, the EU's official procurement journal. Filter by keyword, CPV code, buyer country and date, and get one clean row per notice with the buyer, deadline, estimated value, CPV codes, a link to the tender documents and the TED notice page. Switch to award notices to see who won each contract. Data comes from the official TED Search API. No login, no API key.

**Price:** $0.002 per notice saved (**$2 per 1,000**). No start fee. You pay only for saved rows, and notices removed by your filters are free.

**Try a run for free:** New Apify accounts get the [Free plan](https://apify.com/pricing), with $5 of platform usage credit each month and no credit card, so a test run is covered.

**Try it now:** the form is pre-filled with the keyword `software`, buyers in Germany and France, open calls only, published in the last 7 days, 20 results. Click **Start**. The test run below took about 4 seconds.

### Who uses it

1. **Bid teams and B2G sales.** Get every open call for your service in your target countries each morning. Example: CPV `72` (IT services), countries `DE, NL, AT`, `publishedWithinDays: 1`, scheduled daily, sent to Slack or a sheet.
2. **Competitor and market research.** Set `noticeType` to `result` to see who won contracts in your CPV area, for how much, and how many bids each tender got.
3. **Consultants and tender-writing agencies.** Find buyers with big upcoming projects using `noticeType: planning` and `minEstimatedValueEur`.

### Real run results (20 Nov 2026)

Pre-filled input: `keywords: ["software"]`, `countries: ["DE", "FR"]`, open calls published in the last 7 days, `maxItems: 20` (run `qepfQde9zrWVH1tX2`, about 4 seconds, 256 matching notices on TED, 20 saved, all 20 with a tender documents link). First 6 rows:

| Notice | Title (English label) | Buyer | Country | Deadline |
|---|---|---|---|---|
| 810737-2026 | License management software package – Citrix Subscriptions | Klinikum Idar-Oberstein GmbH | DEU | 2026-12-21 |
| 810715-2026 | IT services: consulting, software development, Internet and support | Vivantes - Netzwerk für Gesundheit GmbH | DEU | 2026-12-21 |
| 810695-2026 | IT services: consulting, software development, Internet and support | Bundesrepublik Deutschland | DEU | 2026-12-03 |
| 810550-2026 | Miscellaneous software development services and computer systems | Etablissement Public Territorial Plaine Commune | FRA | 2026-12-18 |
| 810478-2026 | Communication software package | Centre National d'Enseignement à Distance | FRA | 2027-01-04 |
| 810262-2026 | Maintenance of information technology software | Fraunhofer-Gesellschaft | DEU | 2027-01-12 |

Keyword search is full text in every language, so a word like `software` can also match a cleaning contract that mentions software. For tighter results, add a CPV code such as `72` or `48`.

### Input

| Field | What it does | Example |
|---|---|---|
| `keywords` | Full-text words, combined with OR. | `["cybersecurity", "penetration test"]` |
| `cpvCodes` | CPV codes or prefixes. `72` = IT services, `48` = software, `45` = construction, `79` = business services, `33` = medical. | `["72", "48"]` |
| `countries` | Buyer countries, 2 or 3 letters. | `["DE", "NL", "AT"]` |
| `noticeType` | `competition` (open calls), `result` (awards and winners), `planning` (early notices) or `any`. | `competition` |
| `publishedWithinDays` | Only notices published in the last N days. Default 7. | `1` |
| `onlyOpenDeadlines` | Skip notices whose deadline passed. Default on. Turn off for awards. | `true` |
| `minEstimatedValueEur` | Keep only notices with a value of at least this much. | `100000` |
| `language` | Preferred language for text, 3 letters. | `eng` |
| `expertQuery` | A raw TED expert query that replaces the filters. | `classification-cpv=72* AND buyer-country=NLD` |
| `maxItems` | Stop after this many saved notices. | `500` |

Example, IT contract awards in the Netherlands last month:

```json
{
  "cpvCodes": ["72"],
  "countries": ["NL"],
  "noticeType": "result",
  "publishedWithinDays": 30,
  "onlyOpenDeadlines": false,
  "maxItems": 200
}
```

### Output

```json
{
  "noticeId": "810737-2026",
  "title": "Germany – License management software package – Citrix Subscriptions",
  "originalTitle": "Citrix Subscriptions",
  "noticeType": "cn-standard",
  "formType": "competition",
  "procedureType": "open",
  "contractNature": "supplies",
  "buyerName": "Klinikum Idar-Oberstein GmbH",
  "buyerCountry": "DEU",
  "buyerCity": "Idar-Oberstein",
  "publicationDate": "2026-11-20",
  "deadline": "2026-12-21",
  "daysUntilDeadline": 31,
  "estimatedValue": null,
  "currency": null,
  "cpvCodes": ["48218000", "72260000"],
  "documentsUrl": "https://www.deutsche-evergabe.de/dashboards/dashboard_off/...",
  "winners": [],
  "url": "https://ted.europa.eu/en/notice/-/detail/810737-2026",
  "pdfUrl": "https://ted.europa.eu/en/notice/810737-2026/pdf"
}
```

Other fields: `buyerWebsite`, `placeOfPerformance` (NUTS codes), `description`, `winnerCountries`, `tendersReceived`. In a 7-day German award test, rows showed winners such as AGI - Information Management Consultants (EUR 545,875, 1 bid) and Gurobi GmbH.

### For AI agents

This Actor is `dedicated_crest/ted-eu-tenders-finder`. Call it through the Apify API, the JavaScript or Python client, or [Apify's MCP server](https://mcp.apify.com/?tools=dedicated_crest/ted-eu-tenders-finder). Send `keywords` and/or `cpvCodes` (arrays of strings), `countries` (array of 2 or 3 letter codes), `noticeType` and `maxItems`. Each row is one notice with `noticeId`, `title`, `buyerName`, `buyerCountry`, `deadline`, `estimatedValue`, `winners` and `url`. If nothing matches, the run fails with a message that says which filter to loosen, so an agent never gets a silent empty result.

### Good to know

- **Source and license.** TED is run by the Publications Office of the EU. Its data is free to reuse, including commercially, under the EU's open data policy.
- **Values.** Many buyers do not publish an estimated value, so `estimatedValue` is often empty on open calls. Award notices usually include it.
- **Fails loudly.** An empty search ends as FAILED with a clear reason instead of an empty dataset.
- **Daily alerts.** Schedule it with `publishedWithinDays: 1` and send new rows to email, Slack or Google Sheets.

### Related tools

- [Grants.gov Opportunity Finder](https://apify.com/dedicated_crest/grants-gov-opportunity-finder): US federal grants.
- [USAspending Federal Awards](https://apify.com/dedicated_crest/usaspending-federal-awards): US federal contract and grant awards.

Questions or a missing field? Open an issue on the Issues tab and I'll fix it.

# Actor input Schema

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

Words to find anywhere in the notice, in any EU language, for example 'software', 'cybersecurity' or 'cleaning services'. Several keywords are combined with OR. Leave empty to search by CPV codes or countries only.

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

Optional Common Procurement Vocabulary codes. Short prefixes match every code below them: '72' = all IT services, '48' = software packages, '45' = construction work, '79' = business services, '33' = medical equipment. Full 8-digit codes also work, for example 72212000.

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

Optional buyer country codes, 2 or 3 letters, for example DE, FR, ES, IT, NL, PL or DEU, FRA. Leave empty for all countries that publish on TED.

## `noticeType` (type: `string`):

'competition' = tenders you can bid on now. 'result' = awarded contracts with winner names and values. 'planning' = upcoming tenders announced early.

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

Only notices published on TED in the last N days. Default 7. Use 1 for a daily alert.

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

Skip notices whose tender deadline has already passed or has no deadline. Turn off for award and planning notices. Skipped notices are not charged.

## `minEstimatedValueEur` (type: `integer`):

Optional. Keep only notices with a published estimated or total value of at least this amount in EUR. Notices without a value are skipped when this is set.

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

3-letter language code for titles and buyer names when TED has them in several languages, for example eng, deu, fra. Falls back to English, then the original language.

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

Optional TED expert search query that replaces all filters above, for example: classification-cpv=72\* AND buyer-country=NLD AND publication-date>=20261101. See the TED expert search help.

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

Stop after saving this many notices. You pay only for saved notices.

## Actor input object example

```json
{
  "keywords": [
    "software"
  ],
  "countries": [
    "DE",
    "FR"
  ],
  "noticeType": "competition",
  "publishedWithinDays": 7,
  "onlyOpenDeadlines": true,
  "language": "eng",
  "maxItems": 20
}
```

# Actor output Schema

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

EU public tenders and contract awards with buyer, deadline, value, CPV codes, winners and TED 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",
        "FR"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("dedicated_crest/ted-eu-tenders-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 = {
    "keywords": ["software"],
    "countries": [
        "DE",
        "FR",
    ],
    "maxItems": 20,
}

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dedicated_crest/ted-eu-tenders-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/l56kNRFWiknXGdHEi/builds/byrcYwMVjCmha0Sub/openapi.json
