# EU Tenders from TED with Only-New Mode (`opendatadesk/eu-tenders-ted`) Actor

Search official EU public procurement notices on TED by country, CPV, keyword and date. Run on a schedule to get only new notices. Clean fields, no login.

- **URL**: https://apify.com/opendatadesk/eu-tenders-ted.md
- **Developed by:** [Open Data Desk](https://apify.com/opendatadesk) (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

$1.50 / 1,000 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 Tenders from TED with Only-New Mode

Search official EU public procurement notices from Tenders Electronic Daily (TED), or run a feed that only returns notices published since your last run. Filter by country, CPV code, keyword and date. No login, no proxy.

### What does this Actor do?

It calls the public TED Search API v3 and returns clean English fields for each notice. Typical uses:

- Watch a country and a CPV family every morning for new contracts.
- Collect recent notices in a sector, with buyer, deadline and a link to the official notice.
- Give a bid team a simple table they can open in Excel or a CRM.

### What data do you get?

Each notice is one row.

| Field | What it is |
| --- | --- |
| `publicationNumber`, `publicationDate` | Official notice number (for example 789485-2026) and the publication date |
| `noticeIdentifier` | TED's internal identifier |
| `noticeType`, `procedureType` | For example cn-standard and open |
| `title` | Title, in English when TED publishes an English version |
| `buyerName`, `buyerCountries` | The contracting authority and its country codes |
| `placeOfPerformanceCountries` | Where the work is to be carried out, when published |
| `cpvCodes` | Common Procurement Vocabulary codes |
| `deadlineReceiptTender` | Deadline for tenders, when published |
| `estimatedValue`, `estimatedCurrency` | An estimated value when TED publishes one |
| `totalValue`, `totalCurrency` | A total value on award notices, when published |
| `sourceUrl`, `xmlUrl` | Links to the official HTML notice and the XML |
| `dataSource`, `scrapedAt` | The source line and when the notice was read |

Missing values are `null`. Nothing is guessed. Titles and buyer names can still be in the buyer's language when no English text is published.

#### Example output

One notice from a test run against the official TED API.

```json
{
    "publicationNumber": "789495-2026",
    "publicationDate": "2026-11-13",
    "noticeIdentifier": "214e195e-f0ac-4490-a505-b9f660088ed0",
    "noticeType": "can-standard",
    "procedureType": "open",
    "title": "Denmark – Architectural, construction, engineering and inspection services – Ventilationsservice og ventilationsarbejder",
    "buyerName": "Fællesindkøb Midt | Horsens Kommune",
    "buyerCountries": [
        "DNK"
    ],
    "placeOfPerformanceCountries": [
        "DNK"
    ],
    "cpvCodes": [
        "71000000",
        "45331210",
        "50712000",
        "71315410"
    ],
    "deadlineReceiptTender": null,
    "estimatedValue": null,
    "estimatedCurrency": null,
    "totalValue": "10947025",
    "totalCurrency": "DKK",
    "sourceUrl": "https://ted.europa.eu/en/notice/-/detail/789495-2026",
    "xmlUrl": "https://ted.europa.eu/en/notice/789495-2026/xml",
    "dataSource": "Source: Tenders Electronic Daily (TED), Publications Office of the European Union. Procurement notices may be reused under the European Commission reuse policy.",
    "scrapedAt": "2026-11-16T14:27:25.135Z"
}
```

### Get only new notices

Switch on `Only notices new since my last run` and run the Actor on a schedule, for example every weekday morning. Each run remembers the newest publication date it returned, and the next run continues from there. You get each notice once. The first run looks back 7 days unless you set a start date. Use `Name of this feed` to keep separate feeds, for example one per country or CPV family.

### How to use it

1. Open the Input tab.
2. Set a date window, or leave it empty to use the last 7 days.
3. Optionally add buyer countries (DK, FR, DE or the three-letter codes), CPV codes (`72*` matches the IT family) and keywords.
4. Set `Max notices` and click Start.
5. Download the result as JSON, CSV or Excel, or read it with the API.

If you already have a TED expert-search expression, paste it in `Expert query`. That replaces the other filters.

### Input options

- **Published in the last N days**, **Published from**, **Published to**.
- **Buyer countries**: two- or three-letter ISO codes.
- **CPV codes**: a trailing `*` is allowed.
- **Keywords**: each keyword must appear in the notice.
- **Notice types**: for example `cn-standard` (contract notice) or `can-standard` (award).
- **Search scope**: all searchable notices, only active ones, or the latest Official Journal S issue.
- **Max notices**.

### Limits

- The public API can return at most a few thousand notices for one query in page mode. This Actor walks results in iteration mode and stops when it has enough rows, or after a large number of pages. Narrow the date range if you need a complete slice of a busy query.
- TED may report a timed-out search. When that happens, the Actor says so in the summary and the log. Narrow the query and try again.
- Only electronically signed notices in the Official Journal are authentic. This Actor returns the search fields, plus a link to the official notice.

### How much does it cost?

You pay for each notice that is returned. Searches that return nothing are free. The price per 1,000 notices is shown at the top of this page, and you can set a maximum cost per run.

### Data source and legal

The data comes from the public TED Search API v3 (https://docs.ted.europa.eu/api/latest/search.html, no login). According to the TED legal notice (https://ted.europa.eu/en/legal-notice, checked November 2026), procurement notices published in the Supplement to the Official Journal of the EU can be freely reused for commercial or non-commercial purposes, under the European Commission's reuse policy (Commission Decision of 12 December 2011). Editorial content on the TED websites is licensed under CC BY 4.0; this Actor does not copy that editorial content and does not use TED or SIMAP logos.

This Actor is not made by or connected to the Publications Office of the European Union. You are responsible for following the reuse terms that apply to your use. Please also respect TED's fair use limits if you run very large jobs (https://ted.europa.eu/en/news/fair-usage-policy-on-ted).

### Issues and requests

If a field looks wrong or you need another filter, please open an issue on the Issues tab with your input and the publication number.

# Actor input Schema

## `publishedInLastDays` (type: `integer`):

Only notices published in this many days. If you leave the dates empty and set no other filter, the Actor uses the last 7 days.

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

Format YYYY-MM-DD.

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

Format YYYY-MM-DD.

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

ISO country codes, two or three letters, for example DK, DNK, FR or DE. Several countries are combined with OR.

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

Common Procurement Vocabulary codes. A trailing \* matches a family, for example 72\* for IT services.

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

Words that must appear in the notice. Each keyword is required.

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

For example cn-standard, can-standard or pin-only. Leave empty for all types.

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

A full TED expert-search expression. When set, it replaces the filters above. Example: PD >= 20261101 AND CY=DNK AND PC=72\*

## `onlyNewSinceLastRun` (type: `boolean`):

Remembers the newest publication date returned. Run it on a schedule to get each new notice once. The first run looks back 7 days unless you set a start date.

## `stateName` (type: `string`):

Use different names to keep separate 'new since last run' feeds, for example one per country.

## `scope` (type: `string`):

ALL covers the searchable TED window (about ten years). ACTIVE is currently active notices. LATEST is the current Official Journal S release.

## `onlyLatestVersions` (type: `boolean`):

Skip older versions when a notice has been updated.

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

Stops after this many notices.

## Actor input object example

```json
{
  "publishedInLastDays": 3,
  "countries": [
    "DK"
  ],
  "onlyNewSinceLastRun": false,
  "stateName": "default",
  "scope": "ALL",
  "onlyLatestVersions": true,
  "maxItems": 25
}
```

# Actor output Schema

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

Dataset of procurement notices returned by the run. Each item is one notice.

## `summary` (type: `string`):

A short JSON summary of the run, including counts.

# 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 = {
    "publishedInLastDays": 3,
    "countries": [
        "DK"
    ],
    "maxItems": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("opendatadesk/eu-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 = {
    "publishedInLastDays": 3,
    "countries": ["DK"],
    "maxItems": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("opendatadesk/eu-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 '{
  "publishedInLastDays": 3,
  "countries": [
    "DK"
  ],
  "maxItems": 25
}' |
apify call opendatadesk/eu-tenders-ted --silent --output-dataset

```

## MCP server setup

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