# EU Public Tenders (TED) Scraper: Bids & Contract Notices (`lindenbyte/eu-ted-tenders-scraper`) Actor

Search EU public procurement tenders on TED by keyword, country, CPV code and notice type. Official API, structured data, schedule daily for new-tender alerts.

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

## Pricing

Pay per event

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 (TED) Scraper

Find public tenders and contract awards from all EU/EEA countries on **TED (Tenders Electronic Daily)**, the official EU public procurement journal. Built on the **official public TED API**, so there are no proxies, no login and no broken HTML parsing. You get structured JSON, CSV or Excel with buyer, deadline, estimated value, CPV codes and direct links to the notice, PDF and XML.

Schedule it daily with `publishedWithinDays = 1` and you have a **new-tender alert** feed for any country, sector or keyword.

### What can you do with it?

- **Daily tender alerts:** schedule a daily run and send new tenders to Slack, email, Google Sheets, Zapier, Make or n8n.
- **Lead generation:** find public buyers (ministries, municipalities, hospitals, utilities) looking for what you sell.
- **Bid pipeline:** pull every open contract notice for your CPV codes and countries, sorted by deadline.
- **Market research:** see who buys what, where and for how much, using estimated values and award notices.
- **Competitor tracking:** use award notices (`can-standard`) to see which contracts were awarded.

### Input

| Field | Example | Notes |
|---|---|---|
| `keywords` | `software`, `cloud hosting` | Full-text search in any EU language, OR-combined. Empty = no keyword filter. |
| `buyerCountries` | `BGR`, `DEU`, `FRA` | ISO 3166 alpha-3 codes. Empty = all EU/EEA. |
| `cpvCodes` | `72000000` (IT services), `45000000` (construction) | Common Procurement Vocabulary. |
| `noticeTypes` | `cn-standard`, `can-standard`, `pin-only` | Contract notices, award notices, prior information notices. |
| `contractNature` | services / supplies / works | Default: any. |
| `publishedWithinDays` | `1` | Use 1 with a daily schedule for alerts. |
| `maxResults` | `100` | Maximum tenders per run (you pay per tender). |

### Output example

One dataset item per notice:

```json
{
  "noticeId": "748526-2026",
  "title": "Внедряване на решение за управление на производството на топлинна и електрическа енергия",
  "noticeType": "cn-standard",
  "procedureType": "open",
  "contractNature": ["services"],
  "buyer": "ТОПЛОФИКАЦИЯ СОФИЯ ЕАД",
  "buyerCountry": "BGR",
  "buyerCity": "гр. София",
  "placeOfPerformanceCountries": ["BGR"],
  "cpvCodes": ["72000000"],
  "publicationDate": "2026-10-28",
  "deadline": "2026-11-27",
  "estimatedValue": 690000,
  "currency": "EUR",
  "description": "Предметът на обществената поръчка е „Внедряване на решение за управление ...",
  "url": "https://ted.europa.eu/en/notice/-/detail/748526-2026",
  "pdfUrl": "https://ted.europa.eu/en/notice/748526-2026/pdf",
  "xmlUrl": "https://ted.europa.eu/en/notice/748526-2026/xml"
}
```

**Award notices** (`noticeTypes: ["can-standard"]`) also fill `winners` (company names), `winnerCountries`, `winnerCities`, `winnerSize` (micro/sme/large), `awardedValue` and `awardedCurrency` - useful for competitor and market research. These fields are empty for open tenders.

Titles and descriptions are returned in English when the notice has an English version, otherwise in the buyer's original language.

### How to set up daily tender alerts

1. Choose your countries, CPV codes and/or keywords and set `publishedWithinDays` to `1`.
2. Click **Save**, then **Schedule** and choose "Daily".
3. Under **Integrations**, add Slack, email, Google Sheets or a webhook (Zapier / Make / n8n) that fires when the run succeeds.
4. Every morning you get only the tenders published since the last run.

### Pricing

Pay per result: a small fee per tender returned plus a tiny fee per run. Set a maximum charge per run in the run options and the Actor stops cleanly when it reaches it. A daily alert run returning 20 tenders costs a few cents.

### FAQ

**Do I need a TED account or API key?** No. The TED search API is public.

**Which countries are covered?** All countries that publish on TED: the EU member states plus EEA and other participating countries.

**Are below-threshold national tenders included?** Only if the buyer published them on TED. Many small national tenders appear only on national portals.

**How do I find CPV codes?** Search "CPV code" plus your sector, or use a top-level division such as `72000000` (IT), `79000000` (business services), `45000000` (construction).

**Can I get the full tender documents?** The output links to the notice page, PDF and XML. Procurement documents are usually linked from the notice page.

### Notes

- Data is public information published by the Publications Office of the European Union.
- Not affiliated with the European Union. Independent tool by Lindenbyte.
- Found a bug or need a field? Open an issue on the Actor's Issues tab.

# Actor input Schema

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

Full-text search in any EU language (OR-combined). Empty = no keyword filter.

## `buyerCountries` (type: `array`):

e.g. BGR, DEU, FRA, POL. Empty = all EU/EEA.

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

Common Procurement Vocabulary codes, e.g. 72000000 (IT services), 45000000 (construction). Empty = all.

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

Optional TED notice-type codes, e.g. cn-standard (contract notice), can-standard (award notice), pin-only (prior information). Empty = all.

## `contractNature` (type: `string`):

Only tenders for services, supplies or works. Leave empty for all.

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

Use 1 with a daily schedule for new-tender alerts.

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

Maximum number of tenders to return (you are charged per tender).

## Actor input object example

```json
{
  "keywords": [
    "software"
  ],
  "buyerCountries": [
    "DEU"
  ],
  "contractNature": "any",
  "publishedWithinDays": 7,
  "maxResults": 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 = {
    "keywords": [
        "software"
    ],
    "buyerCountries": [
        "DEU"
    ]
};

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

# Run the Actor and wait for it to finish
run = client.actor("lindenbyte/eu-ted-tenders-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 '{
  "keywords": [
    "software"
  ],
  "buyerCountries": [
    "DEU"
  ]
}' |
apify call lindenbyte/eu-ted-tenders-scraper --silent --output-dataset

```

## MCP server setup

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