# EU Tenders (TED): procurement notices by keyword and country (`steadydata/eu-tenders`) Actor

Public procurement notices from TED, the EU's official tender journal, by keyword, country, CPV code and notice type: buyer, title, value, deadline, procedure, place of performance and links, from the official API. Up to 50 searches a run, filter on publication date. Pay per notice.

- **URL**: https://apify.com/steadydata/eu-tenders.md
- **Developed by:** [Steadydata Team](https://apify.com/steadydata) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.30 / 1,000 notice listeds

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 Tenders (TED): procurement notices by keyword and country

Public procurement notices from TED, the EU's official tender journal, by keyword, country, CPV code and notice type: buyer, title, value, deadline, procedure, place of performance and links, from the official API. Up to 50 searches a run, filter on publication date. Pay per notice.

### Why this scraper

- **Only delivered results are charged.** Inputs that fail come back as clear error
  records at no cost.
- Straight from the Publications Office's own search API, the same source as ted.europa.eu, no HTML and no proxy tricks. Measured on the platform: 200 Dutch contract notices for two search terms in 14 seconds for an eighth of a cent.
- One row per notice with what a bid team needs to decide in a glance: buyer and its country, the title in English and in the original language, estimated value and currency, deadline for bids, procedure type, contract nature (works, supplies, services), main and additional CPV codes, place of performance, the buyer's sector, and the notice and PDF links.
- Filters that map to how procurement is actually searched: free text, buyer countries (ISO codes), CPV codes, notice type (open contract notices, awards, prior information) and a published-since date, so a daily run returns only what is new.
- Newest first, with a per-search ceiling, so a broad term does not become a surprise bill.

### Who this is for

Put search terms in `queries` (up to 50 per run), set `countries` (three-letter ISO codes such as NLD, DEU, FRA), optionally `cpvCodes`, `noticeTypes` (default `cn-standard`, the open contract notices), `publishedSince` (YYYY-MM-DD) and `maxNoticesPerQuery` (default 100). Built for bid teams and sales teams that watch public buyers, market research on public spending by sector and country, and lead lists of authorities that buy what you sell.

### Who this is not for

TED carries notices above the EU thresholds and what member states publish voluntarily; small national tenders below the thresholds are on national portals (for the UK, see the related actor). The description is in English only when the buyer or TED provides one, otherwise in the buyer's language. `estimatedValue` is what the buyer typed, sometimes a placeholder like 1, and empty for the many buyers that publish no value; it is never estimated. Award notices (`can-standard`) have no deadline. A search needs at least a term, a country or a CPV code; an empty search would list all of Europe and is refused for free.

### Input example

```json
{
    "queries": [
        "software",
        "consultancy services"
    ],
    "countries": [
        "NLD"
    ],
    "noticeTypes": [
        "cn-standard"
    ],
    "maxNoticesPerQuery": 100
}
```

### Output example

- `publicationNumber`
- `title`
- `titleOriginal`
- `buyerName`
- `buyerCountry`
- `buyerCity`
- `buyerWebsite`
- `placeOfPerformance`
- `publicationDate`
- `deadline`
- `estimatedValue`
- `currency`
- `mainCpv`
- `cpvCodes`
- `noticeType`
- `procedureType`
- `contractNature`
- `mainActivity`
- `description`
- `url`
- `pdfUrl`
- `query`

Error codes: `INVALID_QUERY`, `NO_RESULTS`, `BLOCKED`.

One delivered row looks like this (description shortened):

```json
{
  "publicationNumber": "658908-2026",
  "title": "Netherlands – Advertising management services – Mediadiensten",
  "titleOriginal": "Mediadiensten",
  "buyerName": "Voedingscentrum Nederland",
  "buyerCountry": "NLD",
  "buyerCity": "'S-GRAVENHAGE",
  "buyerWebsite": "http://www.voedingscentrum.nl",
  "placeOfPerformance": [
    "NL411",
    "NL414",
    "NL415",
    "NL416",
    "NL421",
    "NL422",
    "NL423",
    "NLD"
  ],
  "publicationDate": "2026-09-24",
  "deadline": "2026-11-02",
  "estimatedValue": 1,
  "currency": "EUR",
  "mainCpv": "79341200",
  "cpvCodes": [
    "79341200",
    "79341100",
    "79341400"
  ],
  "noticeType": "cn-standard",
  "procedureType": "open",
  "contractNature": "services",
  "mainActivity": "gen-pub",
  "description": "Eén van de activiteiten van het Voedingscentrum is het voeren van een aantal publiekscampagnes, die met name inzetten op een breed bereik en kennisoverdracht.",
  "url": "https://ted.europa.eu/en/notice/-/detail/658908-2026",
  "pdfUrl": "https://ted.europa.eu/en/notice/658908-2026/pdf",
  "query": "consultancy services",
  "status": "ok"
}
```

### Related actors from steadydata

- [uk-contracts-finder](https://apify.com/steadydata/uk-contracts-finder): the same for UK public sector tenders and awards
- [sec-edgar-filings](https://apify.com/steadydata/sec-edgar-filings): official filings of US-listed companies
- [google-news](https://apify.com/steadydata/google-news): press coverage of a buyer or a project

### Pricing

Pay per event: one `notice-listed` event per delivered result. No charge for inputs
that fail, no separate platform-usage surcharge.

**Free Apify plan:** this actor delivers up to 25 rows per run for accounts on the Apify free
plan, and then stops with a message. That limit is set by us, not by Apify. It exists so the
actor keeps paying for itself for the people who do pay. Any paid Apify plan runs it at full
size, billed per delivered row, with failed rows never charged.

**Reviews:** if this actor saves you time, a short review on this page is the one thing that
helps most. Ratings are what other buyers look at first, and we have no other way to ask.

### FAQ

**Is personal data collected?**
No. Rows carry the contracting authority and the notice; the contact person named on a notice is not read.

**How do I get only new tenders every morning?**
Run with `publishedSince` set to yesterday and your countries and CPV codes. Searches with nothing new come back as a free `NO_RESULTS` row.

**What is a CPV code?**
The Common Procurement Vocabulary, the EU's classification of what is bought: 48000000 is software packages, 72000000 IT services, 45000000 construction work. Every notice carries at least one; filter on `cpvCodes` to skip the keyword guesswork.

**Can I get award notices to see who won?**
Yes: set `noticeTypes` to `can-standard`. Those rows have no deadline; the winning bidder is in the notice behind `url` (the API does not expose it as a field for every notice type).

**Why is the title in English but the description in Dutch?**
TED translates titles into all EU languages; descriptions are published in the buyer's language only, unless the buyer supplied an English one. The original title is kept in `titleOriginal`.

**What does a run cost when a search finds nothing?**
Nothing. `NO_RESULTS`, `INVALID_QUERY` and `BLOCKED` rows are free; only delivered notices are charged.

**What happens when the source changes?**
Sources change from time to time; that is the nature of this work. The actor is
monitored daily and fixed fast, and while it is broken you are not charged, because
only delivered results cost anything.

# Changelog

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

# Actor input Schema

## `queries` (type: `array`):

One search per row, up to 50: words that must appear in the notice text, for example software licences. Empty text with a country or CPV filter lists everything that matches the filters.

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

Three-letter ISO codes of the buyer's country, for example NLD, DEU, FRA. Empty means every country.

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

Common Procurement Vocabulary codes the notice is classified under, for example 48000000 for software packages. Empty means every code.

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

cn-standard for contract notices (open tenders), can-standard for award notices, pin-only for prior information. Empty means contract notices.

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

Only notices published on or after this date (YYYY-MM-DD). Empty means the most recent notices.

## `maxNoticesPerQuery` (type: `integer`):

Cost ceiling per search, newest first.

## Actor input object example

```json
{
  "queries": [
    "software",
    "consultancy services"
  ],
  "countries": [
    "NLD"
  ],
  "noticeTypes": [
    "cn-standard"
  ],
  "maxNoticesPerQuery": 100
}
```

# Actor output Schema

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

No description

# 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 = {
    "queries": [
        "software",
        "consultancy services"
    ],
    "countries": [
        "NLD"
    ],
    "noticeTypes": [
        "cn-standard"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("steadydata/eu-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 = {
    "queries": [
        "software",
        "consultancy services",
    ],
    "countries": ["NLD"],
    "noticeTypes": ["cn-standard"],
}

# Run the Actor and wait for it to finish
run = client.actor("steadydata/eu-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 '{
  "queries": [
    "software",
    "consultancy services"
  ],
  "countries": [
    "NLD"
  ],
  "noticeTypes": [
    "cn-standard"
  ]
}' |
apify call steadydata/eu-tenders --silent --output-dataset

```

## MCP server setup

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