# EU Tenders TED Scraper – Public Procurement Notices & CPV (`flets_sv/ted-eu-tenders`) Actor

Search EU public tenders on TED by country, CPV code, keyword and deadline: buyer, estimated value, deadline and links. Ready for bid-alert workflows.

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

## Pricing

$3.00 / 1,000 tender notice returneds

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 TED Scraper – Public Procurement Notices & CPV

Search public tenders across the European Union with the official TED (Tenders Electronic Daily) API: filter by country, CPV code, keyword, contract type and deadline, and get buyer, estimated value and direct links. *Versión en español más abajo.*

***

### Use cases

- Bid managers: daily list of open tenders in your CPV codes and countries
- Competitor intelligence: contract award notices with winners and values
- Consultancies: find Spanish and EU buyers that need your service
- Market sizing: total estimated value by country and sector

### English

#### What does it do?

The Actor builds an expert query for TED, pages through the results and returns one clean record per notice: publication number, title (Spanish or English first), contracting authority, country, publication date, submission deadline and days left, notice type, contract nature, procedure, CPV codes, estimated value and currency, a short description and links to the notice and the PDF. Use it for open tenders (contract notices) or for award notices to see who won.

#### Input

- `palabrasClave`: full-text search in any EU language.
- `paises`: ISO-3 buyer countries (ESP, FRA, DEU...). Empty for the whole EU.
- `cpv`: CPV code prefixes such as 72 or 45.
- `tipoContrato`: supplies, services, works or any.
- `tipoAviso`: contract notices, award notices, prior information or any.
- `diasAtras`, `soloAbiertos`, `valorMinimo`, `maxItems`.

The default input already works: press **Start** and you get results in seconds.

Example:

```json
{"palabrasClave":"software","paises":["ESP"],"diasAtras":30,"maxItems":10}
```

#### Output

One record per result with: `numeroPublicacion`, `titulo`, `comprador`, `paisComprador`, `fechaPublicacion`, `fechaLimite`, `diasRestantes`, `tipoAviso`, `tipoContrato`, `procedimiento`, `cpv`, `valorEstimado`, `moneda`, `descripcion`, `urlAviso`, `urlPdf`.

#### Pricing (pay per event)

| Event | Price | Per 1,000 |
|---|---|---|
| Tender notice returned (`tender-notice`) | $0.003 | $3.00 |

You only pay for results returned. Set a maximum spend per run and the Actor stops when the limit is reached, keeping what it saved. The Apify FREE plan includes monthly credit to try it.

#### Integrations (Make, Zapier, Google Sheets)

- **Make**: add the Apify module "Run an Actor" (Actor `Flets_sv/ted-eu-tenders`), paste the input JSON, chain "Get Dataset Items" and map the fields to Google Sheets, Slack, Airtable or your CRM.
- **Zapier**: the Apify app offers "Run Actor" and "Fetch Dataset Items". Add a Schedule trigger and send each row to Gmail, Slack or Notion.
- **Google Sheets**: enable the official Google Sheets integration in the Actor's Integrations tab to append every run to a sheet, or call `https://api.apify.com/v2/acts/Flets_sv~ted-eu-tenders/run-sync-get-dataset-items?format=csv` with POST and your input from Apps Script (`UrlFetchApp`).
- **API and webhooks**: start the Actor from the REST API, use Schedules for recurring runs and add a webhook to notify your system when a run finishes.

Input to paste into Make or Zapier:

```json
{"palabrasClave":"software","paises":["ESP"],"diasAtras":30,"maxItems":10}
```

#### FAQ

**Does it need an API key?** No. TED search is open and free; the Actor uses the official API.

**How is this different from Spanish PLACSP tenders?** TED holds the above-threshold tenders of all EU countries, including Spain. For Spanish national and regional platforms use our PLACSP Actor.

**Why is the value empty?** Some notices do not declare an estimated value; `valorEstimado` is then null.

***

### Español

#### ¿Qué hace?

El Actor consulta la API oficial de TED y devuelve una fila por aviso: comprador, país, fechas, plazo restante, tipo de contrato, procedimiento, CPV, valor estimado y enlaces. Sirve para licitaciones abiertas de toda la UE y para avisos de adjudicación (quién ganó y por cuánto).

#### Input

Por defecto busca licitaciones abiertas de software en España de los últimos 30 días y devuelve 10. Usa los mismos campos que la sección inglesa.

#### Output

Un registro por resultado con los campos de la sección inglesa.

#### Precios (pago por evento)

Tender notice returned (`tender-notice`): $0.003 ($3.00 por cada 1.000). Solo pagas por los resultados devueltos y puedes fijar un gasto máximo por ejecución.

#### Integraciones (Make, Zapier, Google Sheets)

- **Make**: añade el módulo de Apify «Run an Actor» (Actor `Flets_sv/ted-eu-tenders`), pega el input JSON y encadena «Get Dataset Items»; después mapea los campos a Google Sheets, Slack, Airtable o tu CRM.
- **Zapier**: la app de Apify ofrece «Run Actor» y «Fetch Dataset Items». Ponle un disparador de horario y envía cada fila a Gmail, Slack o Notion.
- **Google Sheets**: en la pestaña Integrations del Actor activa la integración oficial con Google Sheets para añadir cada ejecución a una hoja, o llama desde Apps Script (`UrlFetchApp`) a `https://api.apify.com/v2/acts/Flets_sv~ted-eu-tenders/run-sync-get-dataset-items?format=csv` con POST y tu input.
- **API y webhooks**: lanza el Actor por API REST, programa ejecuciones (Schedules) y avisa a tu sistema con un webhook al terminar.

Ejemplo de input para pegar en Make o Zapier:

```json
{"palabrasClave":"software","paises":["ESP"],"diasAtras":30,"maxItems":10}
```

#### Preguntas frecuentes

**¿Necesito clave?** No, la API de TED es abierta.

**¿Sirve para licitaciones españolas?** Sí, las de importe europeo. Las menores están en PLACSP.

### Ejemplos de uso / Usage examples

#### Example output (real run, 2026-11-05)

First rows returned by a real run of this Actor on 2026-11-05 (shortened columns, values truncated):

| numeroPublicacion | titulo | comprador | paisComprador | fechaLimite | valorEstimado | moneda |
|---|---|---|---|---|---|---|
| 769304-2026 | Compra conjunta de suscripciones de Productos Microsoft y... | EJIE, S.A. - Sociedad Informática del Gobierno Vasco - EJ... | ESP | 2026-12-07 | 42036127.92 | EUR |
| 767650-2026 | Suministro, instalación y puesta en marcha de equipamient... | Rectorado de la Universidad Rey Juan Carlos | ESP | 2026-11-30 | 240000 | EUR |
| 770980-2026 | Suministro para el mantenimiento de licencias SAP para el... | EJIE, S.A. - Sociedad Informática del Gobierno Vasco - EJ... | ESP | 2026-12-04 | - | - |

#### Copy-paste inputs

**1. Software tenders published in Spain, last 30 days**

```json
{
  "palabrasClave": "software",
  "paises": [
    "ESP"
  ],
  "diasAtras": 30,
  "maxItems": 50
}
```

**2. IT services tenders in Germany and France, open now**

```json
{
  "cpv": [
    "72000000"
  ],
  "paises": [
    "DEU",
    "FRA"
  ],
  "tipoContrato": "services",
  "soloAbiertos": true,
  "maxItems": 100
}
```

#### Call it from your code (Apify API)

```bash
curl -X POST "https://api.apify.com/v2/acts/Flets_sv~ted-eu-tenders/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"palabrasClave": "software", "paises": ["ESP"], "diasAtras": 30, "maxItems": 50}'
```

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("Flets_sv/ted-eu-tenders").call(run_input={"palabrasClave": "software", "paises": ["ESP"], "diasAtras": 30, "maxItems": 50})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

No code? Use the Apify modules for **Make** and **Zapier** (run the Actor, then fetch dataset items), or the **Google Sheets** integration in the Actor's Integrations tab to append each run to a sheet.

### Related Actors / Actores relacionados

Public tenders and grants family by Flets_sv / Familia de licitaciones y ayudas:

- [Spain tenders (PLACSP)](https://apify.com/flets_sv/licitaciones-placsp): Spanish national and regional public tenders.
- [Spain grants and subsidies (BDNS)](https://apify.com/flets_sv/subvenciones-bdns-espana): ayudas y subvenciones de España.
- [UK public tenders](https://apify.com/flets_sv/uk-public-tenders): Find a Tender and Contracts Finder.
- [France tenders (BOAMP)](https://apify.com/flets_sv/boamp-france-tenders): French marchés publics.
- [Australia government contracts (AusTender)](https://apify.com/flets_sv/austender-australia-contracts): federal contracts awarded.

# Actor input Schema

## `palabrasClave` (type: `string`):

Full-text search in the notice, any EU language, e.g. "software", "limpieza", "cloud". Empty returns everything that matches the other filters.

## `paises` (type: `array`):

Countries of the contracting authority: ESP, FRA, DEU, ITA, PRT... Empty means all EU countries.

## `cpv` (type: `array`):

Common Procurement Vocabulary prefixes, e.g. 72 (IT services), 48 (software), 45 (construction), 90 (waste and cleaning).

## `tipoContrato` (type: `string`):

Nature of the contract.

## `tipoAviso` (type: `string`):

Contract notices are open tenders; award notices tell you who won and for how much.

## `diasAtras` (type: `integer`):

Only notices published in this window (1 to 365).

## `soloAbiertos` (type: `boolean`):

Skip contract notices whose submission deadline has already passed.

## `valorMinimo` (type: `integer`):

Skip notices with a smaller declared value. Notices without value are also skipped when above 0.

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

Maximum number of notices returned. It also caps your spend.

## Actor input object example

```json
{
  "palabrasClave": "software",
  "paises": [
    "ESP"
  ],
  "cpv": [],
  "tipoContrato": "any",
  "tipoAviso": "cn-standard",
  "diasAtras": 30,
  "soloAbiertos": true,
  "valorMinimo": 0,
  "maxItems": 10
}
```

# Actor output Schema

## `resultados` (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 = {
    "palabrasClave": "software",
    "paises": [
        "ESP"
    ],
    "diasAtras": 30,
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("flets_sv/ted-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 = {
    "palabrasClave": "software",
    "paises": ["ESP"],
    "diasAtras": 30,
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("flets_sv/ted-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 '{
  "palabrasClave": "software",
  "paises": [
    "ESP"
  ],
  "diasAtras": 30,
  "maxItems": 10
}' |
apify call flets_sv/ted-eu-tenders --silent --output-dataset

```

## MCP server setup

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