# Gov Tender Radar (`zinin/gov-tender-radar`) Actor

Search EU public-sector tenders (TED Europa) by keyword or CPV code, optionally filtered by buyer country. Returns tender title, buyer, country, CPV codes, deadline and notice URL. No API key, no browser — public TED search API only.

- **URL**: https://apify.com/zinin/gov-tender-radar.md
- **Developed by:** [Tim Zinin](https://apify.com/zinin) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 tender founds

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Gov Tender Radar — EU Public Procurement Search (TED)

Point this Actor at keywords or CPV codes and get back matching EU public-sector tenders — title, buyer, buyer country, CPV classification, submission deadline and a direct link to the notice, sorted newest-first. Every result comes straight from TED Europa's own public search API: no scraping, no API key, no login.

### What you get

- **Live tenders, not a stale index.** One row per matching notice: `publicationNumber`, `title`, `buyer`, `buyerCountry`, `cpv`, `deadline`, `publicationDate` and a ready-to-open `url`.
- **Two ways to search.** Plain keywords do a full-text search; TED expert-query field expressions (e.g. `classification-cpv=72000000`) filter directly, and you can mix both with AND/OR.
- **Country filter.** Set `country` to AND an ISO 3-letter buyer-country code into every query.
- **Sorted newest-first** by publication date, so live and upcoming opportunities surface before old, closed notices.
- Runs on Apify: schedule it, monitor it, call it from the API or the MCP server, export to JSON, CSV or Excel, or push results straight into your own pipeline.

### Who uses it

- **Sales & bid teams** — get alerted to a matching tender before half the submission window is already gone.
- **Public-affairs teams & consultants** — track a client's sector or a specific buyer for new notices.
- **Market researchers** — measure procurement activity by country or CPV category over time.

### Why it matters

Companies chasing public-sector contracts either pay for a procurement-alerts SaaS seat or manually refresh the TED Europa website for new notices matching their CPV codes. Both are slow, and by the time a human spots a fresh tender, half the bidding window is already gone.

### How to run it

1. Click **Try for free** — no card needed on the free plan.
2. Paste keywords or TED expert-query expressions into **Search queries**, one per line. Optionally set **Buyer country**.
3. Press **Start**. Results appear in the dataset — read them in the UI, pull them from the API, or have a webhook push them onward.

### Pricing

Pay-per-event: **$0.005 per run start + $0.005 per result found**. No monthly seat, no minimum. 100 matching notices cost about **$0.51**; 1,000 about **$5.01**.

A query that matches nothing, or fails outright, is still returned with `found: false` — and it is **not** charged for. You pay for matches, not for attempts.

### Input

| Field | Required | What it does |
|---|---|---|
| `queries` | yes | Keywords or TED expert-query expressions, one search per entry. Plain words do a full-text search; field expressions (`classification-cpv=72000000`) filter directly; mix both with AND/OR. Up to 25 per run. |
| `country` | no | ISO 3-letter buyer-country code to AND into every query, e.g. `DEU`, `FRA`. Leave empty for all EU countries. |
| `limit` | no | Max notices returned per query (1–100, default 20). |
| `maxConcurrency` | no | Parallel queries against TED (1–8, default 3). |

```json
{
    "queries": ["classification-cpv=72000000", "software"]
}
````

### Output

One row per matched notice, or one graceful "no match" row per query that found nothing. This is a real row from a real run:

```json
{
    "sourceQuery": "classification-cpv=72000000",
    "found": true,
    "publicationNumber": "512430-2026",
    "title": "Portugal – Technical computer support services – Aquisição de serviços de assistência técnica da plataforma SUN Oracle",
    "buyer": "Autoridade Tributária e Aduaneira",
    "buyerCountry": "PRT",
    "cpv": "72611000",
    "deadline": null,
    "publicationDate": "2026-07-24+02:00",
    "url": "https://ted.europa.eu/en/notice/-/detail/512430-2026",
    "matched": null,
    "error": null,
    "summary": "Portugal – Technical computer support services – Aquisição de serviços de assistência técnica da plataforma SUN Oracle — Autoridade Tributária e Aduaneira (PRT).",
    "checkedAt": "2026-07-26T13:58:42.826Z"
}
```

| Field | What it means |
|---|---|
| `sourceQuery` | The query that produced this row |
| `found` | Whether a matching notice was returned |
| `publicationNumber` | TED's notice ID |
| `title` | Notice title (English, or first available language) |
| `buyer` | Contracting authority |
| `buyerCountry` | Buyer's ISO 3-letter country code(s) |
| `cpv` | Common Procurement Vocabulary code(s) |
| `deadline` | Tender submission deadline, when TED has published one — `null` is normal for notice types that don't carry one (e.g. prior information, contract award) |
| `publicationDate` | When the notice was published |
| `url` | Direct link to the notice on ted.europa.eu |

#### Need the rest of the picture?

These run on the same account, take the same shape of input and bill the same way, so they slot into an existing pipeline without new plumbing.

| Actor | What it does |
|---|---|
| [Company Registry Enricher](https://apify.com/zinin/company-registry-enricher) | Turn a company name, LEI or UK company number into an official registry card: legal name, status,… |
| [AI Crawler Access Checker](https://apify.com/zinin/ai-crawler-access-checker) | Check which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended & more) can access your website |
| [B2B Lead Enricher](https://apify.com/zinin/b2b-lead-enricher) | Turn a list of company websites into sales-qualified lead cards: detected tech stack, a rough revenue… |
| [Clinical Trials Monitor](https://apify.com/zinin/clinical-trials-monitor) | Watch conditions, drugs or sponsors for new and updated clinical trials |
| [Company Hiring Radar](https://apify.com/zinin/company-hiring-radar) | Pull every open role a company is hiring for from its public job board (Greenhouse, Lever, Ashby) and turn… |

### FAQ

**Does it need an API key or login?** No — TED Europa's search API is public and keyless.

**How fresh is the data?** Results are sorted newest-first by publication date, so live and just-published notices surface first.

**Why is `deadline` null on some rows?** Not every notice type carries a submission deadline — prior information notices and contract award notices, for example, are informational and won't have one. That's expected, not a missing field.

**Can I call it from an AI agent?** Yes — it's a standard Apify Actor, callable via the Apify API or the Apify MCP server.

**What this is NOT.** It does not evaluate whether you're eligible to bid, does not fetch the full tender documents, and does not cover national-only tenders below the EU publication threshold — only what TED itself publishes.

This Actor surfaces public procurement notices for research and monitoring. It is not legal or bidding advice — verify eligibility, deadline and requirements directly on the official notice before submitting anything.

Found a wrong result, or need a check we don't run? Open an issue on this Actor's page.

***

Built by [zinin](https://apify.com/zinin). Questions? Telegram [@timzinin](https://t.me/timzinin).

# Actor input Schema

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

Keywords or TED expert-query expressions, one search per entry. Plain words (e.g. "software") do a full-text search; field expressions (e.g. "classification-cpv=72000000") filter directly; mix both with AND/OR (e.g. "cloud AND classification-cpv=72\*").

## `country` (type: `string`):

ISO 3-letter buyer-country code to AND into every query, e.g. "DEU", "FRA". Leave empty for all EU countries.

## `limit` (type: `integer`):

Max number of notices to return per query.

## `maxConcurrency` (type: `integer`):

How many queries to run in parallel against TED.

## Actor input object example

```json
{
  "queries": [
    "classification-cpv=72000000",
    "software"
  ],
  "limit": 20,
  "maxConcurrency": 3
}
```

# 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": [
        "classification-cpv=72000000",
        "software"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("zinin/gov-tender-radar").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": [
        "classification-cpv=72000000",
        "software",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("zinin/gov-tender-radar").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": [
    "classification-cpv=72000000",
    "software"
  ]
}' |
apify call zinin/gov-tender-radar --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zinin/gov-tender-radar",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Gov Tender Radar",
        "description": "Search EU public-sector tenders (TED Europa) by keyword or CPV code, optionally filtered by buyer country. Returns tender title, buyer, country, CPV codes, deadline and notice URL. No API key, no browser — public TED search API only.",
        "version": "0.1",
        "x-build-id": "3fepWLzsyoWOrS2fv"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/zinin~gov-tender-radar/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-zinin-gov-tender-radar",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/zinin~gov-tender-radar/runs": {
            "post": {
                "operationId": "runs-sync-zinin-gov-tender-radar",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/zinin~gov-tender-radar/run-sync": {
            "post": {
                "operationId": "run-sync-zinin-gov-tender-radar",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "queries"
                ],
                "properties": {
                    "queries": {
                        "title": "Search queries",
                        "maxItems": 25,
                        "type": "array",
                        "description": "Keywords or TED expert-query expressions, one search per entry. Plain words (e.g. \"software\") do a full-text search; field expressions (e.g. \"classification-cpv=72000000\") filter directly; mix both with AND/OR (e.g. \"cloud AND classification-cpv=72*\").",
                        "items": {
                            "type": "string"
                        }
                    },
                    "country": {
                        "title": "Buyer country (optional)",
                        "type": "string",
                        "description": "ISO 3-letter buyer-country code to AND into every query, e.g. \"DEU\", \"FRA\". Leave empty for all EU countries."
                    },
                    "limit": {
                        "title": "Results per query",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Max number of notices to return per query.",
                        "default": 20
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "maximum": 8,
                        "type": "integer",
                        "description": "How many queries to run in parallel against TED.",
                        "default": 3
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
