# EU TED Tender Scraper (`smarcell/eu-ted-tender-scraper`) Actor Search public EU TED notices via the official TED Search API v3. Filter by country, keywords, CPV, and dates. No login. - **URL**: https://apify.com/smarcell/eu-ted-tender-scraper.md - **Developed by:** [Seres Marcell](https://apify.com/smarcell) (community) - **Categories:** Business, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 ted notices This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ### What does this Actor do? EU TED Tender Scraper looks up **published** public procurement notices on [Tenders Electronic Daily (TED)](https://ted.europa.eu/), the online version of the Supplement to the Official Journal of the EU. It calls the **public TED Search API v3** at `https://api.ted.europa.eu/v3/notices/search`. That endpoint is documented for anonymous reuse of notices that are already on TED. **No API key and no TED login are used.** This Actor does not scrape the TED website HTML, does not bypass access controls, and does not retrieve unpublished notices. Each matching notice is flattened into one dataset item (title, buyer, CPV codes, deadline, links, and value when TED publishes them). ### Ready-to-run examples (no setup) Click **Run** on a pre-configured task — ideal for first-time users: - [Latest EU tenders in Hungary](https://apify.com/smarcell/eu-ted-tender-scraper/examples/hungary-eu-ted-tenders) - [EU construction tenders in Hungary (CPV 45)](https://apify.com/smarcell/eu-ted-tender-scraper/examples/ted-hungary-construction) - [EU IT services tenders in Germany (CPV 72)](https://apify.com/smarcell/eu-ted-tender-scraper/examples/ted-germany-it-services) ### Why use it? - Monitor above-threshold EU tenders for selected buyer countries (default: Hungary). - Filter by keywords, CPV codes, and publication-date range. - Keep a structured dataset you can download as JSON, CSV, Excel, or HTML, or consume through the Apify API and integrations. - Schedule runs on Apify if you want a recurring check. Scheduling is a platform feature; this Actor only queries TED when a run starts. This is a **data retrieval** tool for public notices. It does not bid on tenders, score win probability, generate leads, or produce income. Coverage is limited to what TED publishes through Search API v3. ### What data can it extract? | Field | Type | Description | | --- | --- | --- | | `publicationNumber` | string | TED publication number, e.g. `578401-2026` | | `publicationDate` | string | Publication date (`YYYY-MM-DD`) | | `noticeTitle` | string | Notice title (English when TED provides it, otherwise another language) | | `noticeType` | string | TED notice type code (e.g. `cn-standard`) | | `procedureType` | string | Procurement procedure type when published | | `buyerName` | string | Contracting authority name | | `buyerCountry` | string | Buyer country as TED returns it (ISO 3166-1 **alpha-3**, e.g. `HUN`) | | `cpvCodes` | string\[] | Deduplicated CPV codes | | `deadline` | string or null | Tender receipt deadline when present (`YYYY-MM-DD`) | | `noticeUrl` | string | Human-readable TED notice page | | `xmlUrl` | string | TED XML download URL | | `estimatedValue` | object or null | `{ amount, currency }` from procedure estimated value, or TED `total-value` when that is all TED returns | | `scrapedAt` | string | UTC time when this notice was stored (`YYYY-MM-DDTHH:MM:SSZ`) | TED notices are multilingual and not every field is filled on every form type (contract notices, awards, modifications, etc.). Empty or missing values stay `null` or `[]`. ### How to use 1. Open the Input tab and set **Buyer countries**. Use ISO alpha-2 (`HU`, `DE`) or TED alpha-3 (`HUN`, `DEU`). Two-letter codes are mapped to TED’s alpha-3 `buyer-country` values. 2. Optionally add **Keywords** (full-text `FT~` expert search) and **CPV codes**. 3. Optionally set **Publication date from / to** as `YYYY-MM-DD`. 4. Set **Maximum notices** (1–500, default 50). 5. Run the Actor. Results land in the default dataset. Locally (after installing [Apify CLI](https://docs.apify.com/cli)): ```bash cd eu-ted-tender-scraper apify run --input-file example_input.json ``` Do not put API tokens in the Actor input. TED Search for published notices needs none. Apify platform credentials are only required for `apify push` / cloud runs, and they stay in your CLI or Console environment. ### Input See the **Input** tab for the generated form. Fields: | Field | Required | Default | Notes | | --- | --- | --- | --- | | `countries` | no | `["HU"]` | Buyer country codes. TED rejects alpha-2 in expert search; this Actor maps them. | | `keywords` | no | — | Combined with OR | | `cpvCodes` | no | — | Passed to `classification-cpv`; wildcards such as `72*` are allowed by TED | | `maxItems` | no | `50` | Integer 1–500 | | `dateFrom` | no | — | Inclusive publication date `YYYY-MM-DD` | | `dateTo` | no | — | Inclusive publication date `YYYY-MM-DD` | Example (`example_input.json`) — Hungarian notices published in the week of 21–28 August 2026, capped at five items: ```json { "countries": ["HU"], "dateFrom": "2026-08-21", "dateTo": "2026-08-28", "maxItems": 5 } ``` ### Output You can download the dataset in JSON, HTML, CSV, or Excel. Example item shape (illustrative): ```json { "publicationNumber": "578401-2026", "publicationDate": "2026-08-21", "noticeTitle": "Hungary – Telecommunications services – …", "buyerName": "Budapest Környéki Törvényszék", "buyerCountry": "HUN", "cpvCodes": ["64200000"], "deadline": null, "noticeUrl": "https://ted.europa.eu/en/notice/-/detail/578401-2026", "xmlUrl": "https://ted.europa.eu/en/notice/578401-2026/xml", "estimatedValue": { "amount": 14445600, "currency": "HUF" } } ``` ### Pricing and usage cost - TED Search API v3 access for **published** notices is public and does not require a TED API key. - **Pay-per-event:** each stored notice is charged as event `tender-notice` (see [Pricing tab](https://apify.com/smarcell/eu-ted-tender-scraper/pricing)). - Typical cost: **$0.005 per notice** + small Actor start fee + platform compute. - Apify FREE tier includes **$5/month** usage credits — enough for hundreds of test notices. - Schedule recurring runs on Apify to monitor new tenders automatically. ### Limitations - Only published notices available through TED Search API v3. - TED `buyer-country` is ISO alpha-3. Dataset `buyerCountry` keeps that TED value (`HUN`, not `HU`). - `maxItems` is capped at 500 per run. TED is queried with ITERATION pagination, page size 100. - Historical completeness, translations, estimated values, and deadlines vary by notice type. - The Actor retries transient HTTP errors and TED `timedOut: true` responses; persistent API errors fail the run. - Respect TED’s published conditions for reuse of OJ S / TED data. This Actor is a client of the official API, not an official EU Publications Office product. ### FAQ **Does this need a TED API key?**\ No. Published-notice search is anonymous. Do not add keys to input. **Why did `HU` work as input but the dataset says `HUN`?**\ TED indexes `buyer-country=HUN`. The Actor accepts `HU` in input and maps it. Output preserves TED’s alpha-3 code. **Can I search all EU countries?**\ Yes. Pass several codes, e.g. `["HU", "DE", "AT"]`. Very broad queries with a high `maxItems` take longer and cost more compute. **Does it scrape ted.europa.eu pages?**\ No. It only POSTs to `https://api.ted.europa.eu/v3/notices/search`. ### Source - TED Search API: - TED developers’ corner: ### Related Actors - [Hungary Procurement Monitor](https://apify.com/smarcell/hungary-procurement-monitor) — national tenders below EU threshold (EKR) - [Google Maps Places Scraper](https://apify.com/smarcell/google-maps-places-scraper) — find buyer or contractor contact details - [Website Contact Extractor](https://apify.com/smarcell/website-contact-extractor) — emails and phones from company websites # Actor input Schema ## `countries` (type: `array`): ISO 3166-1 alpha-2 (e.g. HU, DE) or alpha-3 (e.g. HUN, DEU) codes of the contracting authority country. TED indexes buyer-country as alpha-3; two-letter codes are mapped automatically. Default is Hungary. ## `keywords` (type: `array`): Optional full-text terms matched with TED expert search (FT~). Multiple keywords are combined with OR. Leave empty to skip text filtering. ## `cpvCodes` (type: `array`): Optional Common Procurement Vocabulary codes (e.g. 72000000). Wildcards such as 72\* are passed through to TED. Multiple codes are combined with IN. ## `maxItems` (type: `integer`): Maximum number of notices to store. TED is queried in pages of up to 100. ## `dateFrom` (type: `string`): Inclusive lower bound for TED publication date, as YYYY-MM-DD. Leave empty for no lower bound. ## `dateTo` (type: `string`): Inclusive upper bound for TED publication date, as YYYY-MM-DD. Leave empty for no upper bound. ## Actor input object example ```json { "countries": [ "HU" ], "maxItems": 50, "dateFrom": "2026-08-21", "dateTo": "2026-08-28" } ``` # Actor output Schema ## `tenders` (type: `string`): Flattened TED notices stored in the default dataset. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "countries": [ "HU" ], "dateFrom": "2026-08-21", "dateTo": "2026-08-28" }; // Run the Actor and wait for it to finish const run = await client.actor("smarcell/eu-ted-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "countries": ["HU"], "dateFrom": "2026-08-21", "dateTo": "2026-08-28", } # Run the Actor and wait for it to finish run = client.actor("smarcell/eu-ted-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 '{ "countries": [ "HU" ], "dateFrom": "2026-08-21", "dateTo": "2026-08-28" }' | apify call smarcell/eu-ted-tender-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,smarcell/eu-ted-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 ` 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/WaB3P9Kvow7jHz7hc/builds/DhnuQXBqQ4oO40p22/openapi.json