# TED EU Procurement Notices Scraper (`alwaysprimedev/ted-eu-procurement-scraper`) Actor Structured EU public procurement data: tenders, contract awards, notices from ted.europa.eu β€” filter by country, CPV code, date or free text. Built on the official TED API. - **URL**: https://apify.com/alwaysprimedev/ted-eu-procurement-scraper.md - **Developed by:** [Always Prime](https://apify.com/alwaysprimedev) (community) - **Categories:** Automation, Other, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## πŸ‡ͺπŸ‡Ί TED EU Procurement Notices Scraper > Structured public-procurement data from every EU member state, every day. πŸš€ [![Apify](https://img.shields.io/badge/Apify-Actor-blue)](https://apify.com/) [![Python](https://img.shields.io/badge/python-3.11-blue)](https://www.python.org/) [![Output](https://img.shields.io/badge/output-JSON_%7C_CSV_%7C_XLSX-success)](#) Get the **EU's Tenders Electronic Daily** as clean JSON / CSV / Excel β€” filtered by country, CPV code, date range or free-text title search. ⚑️ --- ### πŸ’‘ Why this scraper? - πŸ“¦ **Authoritative source.** Pulls directly from `ted.europa.eu` β€” the EU's official Official Journal Supplement for public procurement. - πŸ€– **No HTML to break.** Uses TED's official structured-data backend, so site redesigns don't break your pipeline. - 🌍 **All 27 member states + 4 EFTA countries** in one dataset. - πŸ’° **Monetizable fields out of the box** β€” buyer, value, currency, deadline, CPV codes, NUTS region, contact email. - 🌐 **Multilingual.** Titles, descriptions and PDFs in any of 24 EU languages β€” pick your preferred locale, fall back to English. - πŸ” **Incremental-friendly.** Schedule daily runs with `daysBack=1` to keep your database fresh without re-scraping history. - πŸ“‘ **Open-data licensed.** TED data is published under CC BY 4.0 (CC0 for metadata), so your downstream use is unencumbered. --- ### πŸš€ Quick start (Apify Console) 1. Click **Try for free** on the Apify Store page. 2. Pick the filters you want β€” country, CPV code, free-text search, date range. 3. Click **Start** ▢️. 4. Download your data as **JSON / CSV / Excel** when the run finishes. That's it. No accounts on TED, no API keys, no proxies to configure. --- ### βš™οΈ Inputs | Field | What it does | | --- | --- | | `searchText` | Phrase search inside notice titles. e.g. `"cloud services"`. | | `cpvCodes` | Common Procurement Vocabulary codes β€” e.g. `72000000` (IT services), `33100000` (medical equipment). | | `buyerCountries` | ISO 3166-1 alpha-3 country codes. e.g. `DEU`, `FRA`, `POL`. | | `noticeTypes` | TED notice types. e.g. `cn-standard` (contract notice), `can-standard` (contract award). | | `dateFrom` / `dateTo` | Publication-date range, `YYYY-MM-DD`. | | `daysBack` | Shortcut: only the last N days (default `7`). | | `scope` | `ACTIVE` (default), `ALL` or `LATEST` (most recent OJ S release only). | | `language` | Preferred ISO 639-3 language for titles/descriptions/PDFs (default `eng`). | | `onlyLatestVersions` | When a notice is corrected, deduplicate to the latest version (default `true`). | | `maxItems` | Hard cap. `0` = unlimited (paginate through every match). | | `pageSize`, `concurrency`, `fields`, `query` | Advanced overrides β€” see schema. | --- ### πŸ“‹ Sample output ```json { "url": "https://ted.europa.eu/en/notice/-/detail/316731-2026", "id": "316731-2026", "scraped_at": "2026-05-10T14:32:11Z", "title": "Germany β€” IT consultancy services β€” Framework agreement for cloud migration support", "description": "Provision of consultancy services for the migration of legacy applications to a sovereign cloud infrastructure...", "notice_type": "cn-standard", "publication_date": "2026-05-08", "procedure_type": "open", "contract_nature": "services", "buyer_name": "Bundesamt fΓΌr Sicherheit in der Informationstechnik", "buyer_country": "DEU", "buyer_city": "Bonn", "buyer_email": "vergabestelle@bsi.bund.de", "buyer_legal_type": "body-pl-cga", "cpv_codes": ["72000000", "72200000", "72220000"], "place_of_performance": ["DEA22", "DEA"], "submission_languages": ["deu"], "deadline_date": "2026-06-15", "deadline_time": "14:00:00+02:00", "total_value": 4800000, "total_value_currency": "EUR", "pdf_url": "https://ted.europa.eu/en/notice/316731-2026/pdf", "xml_url": "https://ted.europa.eu/en/notice/316731-2026/xml" } ```` *** ### 🎯 Use cases | Who | What for | | --- | --- | | 🏒 **Sales / business development** | Identify open tenders matching your service catalogue, qualify by buyer country and budget. | | πŸ“Š **Market research** | Track public-sector demand by CPV category, country and quarter. | | πŸ›οΈ **Policy / academic** | Monitor procurement transparency, study award patterns across EU regions. | | 🀝 **Bid consultants** | Daily digest of relevant new notices delivered to your CRM. | | πŸ› οΈ **GovTech & PropTech platforms** | Enrich your product with always-fresh structured EU procurement data. | *** ### πŸ’‘ Tips & tricks - πŸ“… **For daily monitoring**, run with `daysBack: 1` on a 24h schedule. Costs near-zero at most pricing tiers. - πŸ”Ž **For backfills**, set `dateFrom` / `dateTo` and `maxItems: 0`. The actor automatically switches to scroll pagination above 15k results. - πŸ—‚οΈ **For specific verticals**, combine multiple CPV codes β€” they're OR-combined. - πŸ§ͺ **For exploration**, use `scope: ACTIVE` to skip expired notices. - πŸ›‘οΈ **The `query` advanced field** lets you build any TED expert-search query β€” see [TED Expert Search](https://ted.europa.eu/en/search/expert-search) for the syntax. *** ### ❓ FAQ **Q: How current is the data?** A: Notices appear within minutes of publication on TED's Official Journal Supplement. **Q: How far back can I go?** A: TED's online corpus covers notices from 2014 onward; older notices are archived. `scope: ALL` gives access to everything. **Q: Are personal contact details included?** A: TED publishes only organisational addresses for contracting authorities. There are no personal phone numbers or photos in the dataset. **Q: What's the licence on the resulting data?** A: TED editorial content is **CC BY 4.0** (attribute the EU as the source). Metadata is **CC0** (public domain). Both allow commercial reuse. **Q: Why might `total_value` be null?** A: Many contract notices (`cn-standard`) don't disclose the estimated value before bidding. Contract award notices (`can-standard`) almost always do. *** ### πŸ“œ Source & attribution This actor consumes the publicly available TED Search API documented at [docs.ted.europa.eu](https://docs.ted.europa.eu). When you reuse the data downstream, attribute it as: > Source: TED β€” Tenders Electronic Daily, Publications Office of the European Union β€” Β© European Union, \[year]. *** Made with ❀️ for the European public-procurement data community. # Actor input Schema ## `searchText` (type: `string`): Phrase to search inside the notice title (e.g. 'cloud services', 'medical equipment'). Leave blank to ignore. ## `cpvCodes` (type: `array`): Common Procurement Vocabulary codes to filter on (e.g. 72000000 for IT services, 33100000 for medical equipment). Multiple codes are OR-combined. ## `buyerCountries` (type: `array`): ISO 3166-1 alpha-3 country codes of contracting authorities (e.g. POL, DEU, FRA). Multiple codes are OR-combined. ## `noticeTypes` (type: `array`): TED notice types to include (e.g. cn-standard for contract notice, can-standard for contract award). Leave blank for all types. ## `dateFrom` (type: `string`): Earliest publication date to include, format YYYY-MM-DD. Mutually exclusive with 'Days back'. ## `dateTo` (type: `string`): Latest publication date to include, format YYYY-MM-DD. ## `daysBack` (type: `integer`): Shortcut: only include notices published in the last N days. Ignored if 'Published from' is set. ## `scope` (type: `string`): Which set of notices to search: ALL = every notice ever published, ACTIVE = currently active, LATEST = only the most recent OJ S release. ## `language` (type: `string`): Three-letter ISO 639-3 code used to pick titles, descriptions and PDFs from multilingual fields. Falls back to English if the requested language is not available. ## `onlyLatestVersions` (type: `boolean`): When a notice is corrected and re-published, deduplicate to only the latest version. Recommended for most users. ## `maxItems` (type: `integer`): Hard cap on the number of records returned. Set to 0 for unlimited (the actor will paginate through every matching notice). ## `pageSize` (type: `integer`): Number of notices fetched per API call. Up to 250. Increase for fewer round-trips on large queries. ## `concurrency` (type: `integer`): Number of parallel API requests. The TED API is fast and has generous limits; 5 is safe. ## `fields` (type: `array`): Override the default field set with custom TED API field names. Leave blank to use the recommended defaults. See https://docs.ted.europa.eu for the full field reference. ## `query` (type: `string`): Raw TED expert-search query string. When set, this overrides every other filter on this form. See https://ted.europa.eu/en/search/expert-search for the syntax. ## Actor input object example ```json { "searchText": "cloud services", "cpvCodes": [ "72000000" ], "buyerCountries": [ "DEU", "FRA" ], "noticeTypes": [ "cn-standard", "can-standard" ], "daysBack": 7, "scope": "ACTIVE", "language": "eng", "onlyLatestVersions": true, "maxItems": 1000, "pageSize": 100, "concurrency": 5, "query": "buyer-country = FRA AND classification-cpv = 72000000 AND publication-date >= today(-30)" } ``` # Actor output Schema ## `noticesJson` (type: `string`): Full dataset in JSON. ## `noticesCsv` (type: `string`): Full dataset in CSV. ## `noticesXlsx` (type: `string`): Full dataset in XLSX. ## `consoleView` (type: `string`): Browseable view of the dataset in the Apify UI. # 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 = { "cpvCodes": [ "72000000" ], "daysBack": 7, "scope": "ACTIVE", "language": "eng", "onlyLatestVersions": true, "maxItems": 1000 }; // Run the Actor and wait for it to finish const run = await client.actor("alwaysprimedev/ted-eu-procurement-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 = { "cpvCodes": ["72000000"], "daysBack": 7, "scope": "ACTIVE", "language": "eng", "onlyLatestVersions": True, "maxItems": 1000, } # Run the Actor and wait for it to finish run = client.actor("alwaysprimedev/ted-eu-procurement-scraper").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 '{ "cpvCodes": [ "72000000" ], "daysBack": 7, "scope": "ACTIVE", "language": "eng", "onlyLatestVersions": true, "maxItems": 1000 }' | apify call alwaysprimedev/ted-eu-procurement-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=alwaysprimedev/ted-eu-procurement-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TED EU Procurement Notices Scraper", "description": "Structured EU public procurement data: tenders, contract awards, notices from ted.europa.eu β€” filter by country, CPV code, date or free text. Built on the official TED API.", "version": "0.1", "x-build-id": "OXMseB0GzmfsCqPzE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alwaysprimedev~ted-eu-procurement-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alwaysprimedev-ted-eu-procurement-scraper", "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/alwaysprimedev~ted-eu-procurement-scraper/runs": { "post": { "operationId": "runs-sync-alwaysprimedev-ted-eu-procurement-scraper", "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/alwaysprimedev~ted-eu-procurement-scraper/run-sync": { "post": { "operationId": "run-sync-alwaysprimedev-ted-eu-procurement-scraper", "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", "properties": { "searchText": { "title": "Free-text search", "type": "string", "description": "Phrase to search inside the notice title (e.g. 'cloud services', 'medical equipment'). Leave blank to ignore." }, "cpvCodes": { "title": "CPV codes", "uniqueItems": true, "type": "array", "description": "Common Procurement Vocabulary codes to filter on (e.g. 72000000 for IT services, 33100000 for medical equipment). Multiple codes are OR-combined.", "items": { "type": "string" } }, "buyerCountries": { "title": "Buyer countries", "uniqueItems": true, "type": "array", "description": "ISO 3166-1 alpha-3 country codes of contracting authorities (e.g. POL, DEU, FRA). Multiple codes are OR-combined.", "items": { "type": "string" } }, "noticeTypes": { "title": "Notice types", "uniqueItems": true, "type": "array", "description": "TED notice types to include (e.g. cn-standard for contract notice, can-standard for contract award). Leave blank for all types.", "items": { "type": "string" } }, "dateFrom": { "title": "Published from", "type": "string", "description": "Earliest publication date to include, format YYYY-MM-DD. Mutually exclusive with 'Days back'." }, "dateTo": { "title": "Published to", "type": "string", "description": "Latest publication date to include, format YYYY-MM-DD." }, "daysBack": { "title": "Days back", "minimum": 0, "type": "integer", "description": "Shortcut: only include notices published in the last N days. Ignored if 'Published from' is set.", "default": 7 }, "scope": { "title": "Scope", "enum": [ "ACTIVE", "ALL", "LATEST" ], "type": "string", "description": "Which set of notices to search: ALL = every notice ever published, ACTIVE = currently active, LATEST = only the most recent OJ S release.", "default": "ACTIVE" }, "language": { "title": "Preferred language", "enum": [ "eng", "deu", "fra", "spa", "ita", "pol", "ces", "nld", "por", "swe", "fin", "dan", "ron" ], "type": "string", "description": "Three-letter ISO 639-3 code used to pick titles, descriptions and PDFs from multilingual fields. Falls back to English if the requested language is not available.", "default": "eng" }, "onlyLatestVersions": { "title": "Latest versions only", "type": "boolean", "description": "When a notice is corrected and re-published, deduplicate to only the latest version. Recommended for most users.", "default": true }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Hard cap on the number of records returned. Set to 0 for unlimited (the actor will paginate through every matching notice).", "default": 1000 }, "pageSize": { "title": "Page size (advanced)", "minimum": 1, "maximum": 250, "type": "integer", "description": "Number of notices fetched per API call. Up to 250. Increase for fewer round-trips on large queries.", "default": 100 }, "concurrency": { "title": "Concurrency (advanced)", "minimum": 1, "maximum": 25, "type": "integer", "description": "Number of parallel API requests. The TED API is fast and has generous limits; 5 is safe.", "default": 5 }, "fields": { "title": "Custom fields (advanced)", "uniqueItems": true, "type": "array", "description": "Override the default field set with custom TED API field names. Leave blank to use the recommended defaults. See https://docs.ted.europa.eu for the full field reference.", "items": { "type": "string" } }, "query": { "title": "Expert query (advanced)", "type": "string", "description": "Raw TED expert-search query string. When set, this overrides every other filter on this form. See https://ted.europa.eu/en/search/expert-search for the syntax." } } }, "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 } } } } } } } } } } ```