# TED Europa Tender Scraper (`snappytools/ted-europa-tender-scraper`) Actor

This Actor searches the European Union's Tenders Electronic Daily (TED), the official journal of public procurement notices, using the public TED search API (api.ted.europa.eu v3).

- **URL**: https://apify.com/snappytools/ted-europa-tender-scraper.md
- **Developed by:** [Snappy](https://apify.com/snappytools) (community)
- **Categories:** Other
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.30 / 1,000 results

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 Europa Tender Scraper – EU public procurement notices export

Give it one or more CPV codes (the EU's classification for what is being bought), and optionally a buyer country and a start date. You get back one row per tender notice from Tenders Electronic Daily (TED), the EU's official journal of public procurement.

Each row has the notice ID, title, notice type, buyer name, buyer country, CPV codes, publication date and a link to the official notice. Estimated value, currency and deadline are included when the buyer filled them in. Schedule it to run daily or weekly and you have a steady feed of new tenders in your sector.

### Why this one

- **No account or key needed.** It reads the public TED search API (api.ted.europa.eu v3), so there is nothing to sign up for.
- **Filter by what is being bought.** Enter CPV codes such as `72000000` for IT services and only matching notices come back.
- **Filter by buyer country.** Use ISO alpha-3 codes like `DEU` or `FRA`, or leave it empty to search all countries.
- **Links to the source.** Every row has a `url` pointing to the official notice page so you can check the details before bidding.
- **Consistent rows.** Fields the buyer left blank come back as `null`, so your filters and spreadsheets work the same on every row.
- **Cheap and bounded.** $4.30 per 1,000 results, no start fee, and runs with no results cost nothing.

### Quick start

```json
{
  "countries": ["DEU"],
  "cpvCodes": ["72000000"],
  "maxResults": 5,
  "publishedFrom": ""
}
```

This returns up to 5 recent German IT services notices. In a test run on 5 Nov 2026 it returned 5 results.

### What you can use it for

| Who | What for |
| --- | --- |
| Business development teams | Watch for new EU public tenders in your sector |
| Bid managers | Build a daily or weekly pipeline of opportunities by CPV code |
| Market analysts | Compare procurement activity by country and category |
| Consultants and resellers | Alert clients to contract notices that suit them |
| Sales and CRM teams | Add buyer organisations and deadlines to your sales tools |

### How to use it

1. Click **Try for free**.
2. In **CPV codes**, add one or more 8-digit codes, for example `72000000`. This field is required.
3. In **Buyer countries**, add ISO alpha-3 codes such as `DEU` or `FRA`. Leave it empty for all countries.
4. In **Published from (YYYYMMDD)**, enter a date such as `20261101`. Leave it empty to get the last 30 days.
5. In **Maximum results**, set a number from 1 to 1000. The default is 50.
6. Click **Start**.

To get new tenders regularly, set up a schedule from **Schedules** and run it daily or weekly.

### What data you get

Each result is one tender notice, with these fields.

| Field | What it is | Example |
| --- | --- | --- |
| `id` | TED publication number | `769326-2026` |
| `url` | Link to the official notice | `https://ted.europa.eu/en/notice/-/detail/769326-2026` |
| `title` | Notice title, with country and category | `Germany – Computer network services – Erweiterung der Realisierung von Maßnahmen zur Erhöhung der IT-Sicherheit` |
| `noticeType` | Type of notice | `cn-standard` |
| `buyerName` | Name of the buying organisation | `SRH Gesundheit GmbH` |
| `buyerCountry` | Buyer country, ISO alpha-3 | `DEU` |
| `cpvCodes` | CPV codes on the notice | `["72700000","72100000","72200000"]` |
| `estimatedValue` | Estimated contract value, if given | `210000` |
| `currency` | Currency of the value, if given | `EUR` |
| `deadline` | Submission deadline, if given | `null` |
| `publicationDate` | Date the notice was published | `2026-11-05+01:00` |
| `scrapedAt` | When the row was collected | `2026-11-05T00:49:10.561Z` |

### Pricing

| Event | Price |
| --- | --- |
| Result | $0.0043 |

There is no start fee. Runs with no results cost nothing.

| Run | Cost |
| --- | --- |
| 100 results | $0.43 |
| 1,000 results | $4.30 |
| 10,000 results | $43.00 |

### Good to know

- **Limit per run.** You can get up to 1,000 results in one run. It requests at most 100 notices per page and pauses between pages.
- **Data source.** Everything comes from the public TED search API run by the Publications Office of the European Union.
- **Gaps in the data.** Values, deadlines and names depend on how each buyer filled in the notice. Some fields will be `null`, and text may be in the original language.
- **Check before you bid.** Always confirm critical details on the official notice page.
- **Not affiliated.** This tool isn't affiliated with or endorsed by the European Union or the Publications Office of the European Union.

### Getting the data out

Download the results as Excel, CSV or JSON from the Output tab. Send them to Google Sheets, Slack, Zapier, Make or webhooks from the **Integrations** tab. Every run is also available through the Apify API, and you can schedule runs from **Schedules**.

### Questions or problems

Open an issue on the **Issues** tab and include the run link. I reply within one business day.

### Related tools

- [Companies House Company Scraper](https://apify.com/snappytools/companies-house-uk-scraper): look up UK company records
- [Bulk Email Syntax and MX Validator](https://apify.com/snappytools/email-syntax-mx-validator): check lists of email addresses in bulk

# Actor input Schema

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

List of CPV classification codes (8 digits, e.g. 72000000 for IT services) used to filter notices.

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

ISO 3166-1 alpha-3 country codes of the buyer, e.g. DEU, FRA. Leave empty for all countries.

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

Only notices published on or after this date, formatted YYYYMMDD. Leave empty for last 30 days.

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

Maximum number of notices to return in one run (1 to 1000) to keep costs bounded.

## Actor input object example

```json
{
  "cpvCodes": [
    "72000000"
  ],
  "countries": [
    "DEU"
  ],
  "publishedFrom": "",
  "maxResults": 20
}
```

# 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 = {
    "cpvCodes": [
        "72000000"
    ],
    "countries": [
        "DEU"
    ],
    "publishedFrom": "",
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("snappytools/ted-europa-tender-scraper").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 = {
    "cpvCodes": ["72000000"],
    "countries": ["DEU"],
    "publishedFrom": "",
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("snappytools/ted-europa-tender-scraper").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 '{
  "cpvCodes": [
    "72000000"
  ],
  "countries": [
    "DEU"
  ],
  "publishedFrom": "",
  "maxResults": 20
}' |
apify call snappytools/ted-europa-tender-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,snappytools/ted-europa-tender-scraper"
        }
    }
}
```

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/nuOe7V5GD99mTB2LE/builds/Et1Fr1Fg1FQuji1Zs/openapi.json