# TED EU Procurement Scraper — Public Tenders (`studio-amba/ted-eu-procurement-scraper`) Actor Scrape EU public procurement notices from TED (Tenders Electronic Daily). Search by keyword, country, or CPV code. Extract tender titles, buyers, deadlines, estimated values, and award details. Covers all EU/EEA member states. - **URL**: https://apify.com/studio-amba/ted-eu-procurement-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Scraper Scrape public procurement notices from TED (Tenders Electronic Daily), the official platform for EU public procurement. Extract tender details including buyer information, deadlines, estimated values, CPV codes, and contract awards across all EU/EEA member states. ### How to scrape EU public procurement data from TED TED (Tenders Electronic Daily) is the official journal for European public procurement. It publishes around 700,000 procurement notices per year from all EU member states plus EEA countries. This actor lets you search and extract structured data from these notices programmatically. #### What is TED? TED is run by the Publications Office of the European Union. All public contracts above certain thresholds in the EU must be published here. This includes: - Public works contracts - Supply contracts - Service contracts - Concession contracts - Design contests The data is essential for businesses looking for government contract opportunities, market researchers analyzing public spending, and journalists investigating procurement patterns. ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchQuery` | string | `software` | Keyword to search in procurement notices | | `country` | string | (all) | ISO 2-letter country code to filter by buyer country | | `cpvCode` | string | (none) | Common Procurement Vocabulary code to filter by sector | | `daysBack` | integer | `30` | Only return notices published within this many days | | `maxResults` | integer | `100` | Maximum number of notices to return | | `proxyConfiguration` | object | Apify Proxy | Proxy settings | #### Example Input ```json { "searchQuery": "cloud computing", "country": "DE", "cpvCode": "72000000", "daysBack": 14, "maxResults": 50 } ```` ### Output Format Each result contains the following fields: | Field | Type | Description | |-------|------|-------------| | `noticeId` | string | TED notice identifier (e.g., "123456-2026") | | `noticeTitle` | string | Title of the procurement notice | | `buyer` | string | Name of the contracting authority | | `buyerCountry` | string | Country of the buyer (ISO code) | | `publicationDate` | string | Date the notice was published | | `deadline` | string | Submission deadline for tenders | | `estimatedValue` | number | Estimated contract value | | `currency` | string | Currency of the estimated value | | `cpvCodes` | array | CPV classification codes | | `procedureType` | string | Type of procurement procedure | | `documentType` | string | Notice type (Contract notice, Award, etc.) | | `noticeDescription` | string | Description of the procurement | | `url` | string | Direct link to the notice on TED | | `awardedTo` | string | Winner name (for contract awards) | | `awardedValue` | number | Final contract value (for awards) | #### Example Output ```json { "noticeId": "234567-2026", "noticeTitle": "Cloud Infrastructure Services for Federal Agency", "buyer": "Federal Ministry of the Interior", "buyerCountry": "DE", "publicationDate": "2026-05-15", "deadline": "2026-06-30", "estimatedValue": 2500000, "currency": "EUR", "cpvCodes": ["72000000", "72310000"], "procedureType": "Open procedure", "documentType": "Contract notice", "noticeDescription": "Provision of cloud infrastructure services...", "url": "https://ted.europa.eu/en/notice/-/detail/234567-2026", "awardedTo": null, "awardedValue": null } ``` ### Common CPV Codes Use these CPV codes to filter by sector: | Code | Sector | |------|--------| | `45000000` | Construction work | | `72000000` | IT services | | `33000000` | Medical equipment | | `34000000` | Transport equipment | | `50000000` | Repair and maintenance | | `71000000` | Architectural and engineering | | `79000000` | Business services | | `80000000` | Education and training | | `85000000` | Health and social services | | `90000000` | Sewage and refuse services | ### Use Cases - **Business development**: Find relevant public tenders in your sector and geography - **Market research**: Analyze public spending patterns across EU countries - **Competitive intelligence**: Track which companies win contracts in your domain - **Journalism**: Investigate procurement patterns and public spending - **Compliance monitoring**: Track procurement from specific authorities - **Price benchmarking**: Compare awarded contract values across regions ### Supported Countries All EU/EEA member states publish on TED, including: AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK + EEA (IS, LI, NO) ### Tips - Use broad keywords for more results (e.g., "software" instead of "cloud-native microservices platform") - CPV codes are hierarchical: `72000000` covers all IT, while `72310000` is specifically data processing - Contract awards contain winner information, useful for competitive analysis - Combine country filter with CPV code for highly targeted results - The `daysBack` parameter helps focus on recent opportunities ### Limitations - TED occasionally changes its page structure, which may temporarily affect parsing - Some fields may be empty if not available in the notice listing - Full notice text requires following the URL to the detail page - Historical notices older than 5 years may not be available ### Cost of Usage This actor uses Apify Proxy for reliable access. Typical costs depend on the number of pages scraped. A search returning 100 results usually costs less than $0.05 in platform credits. ### Support For issues or feature requests, contact the developer or open an issue on the actor's GitHub repository. # Actor input Schema ## `searchQuery` (type: `string`): Keyword to search for in procurement notices. Examples: 'software', 'construction', 'medical equipment'. ## `country` (type: `string`): Filter by buyer country using ISO 2-letter code (e.g., 'BE', 'DE', 'FR'). Leave empty for all countries. ## `cpvCode` (type: `string`): Filter by Common Procurement Vocabulary code (e.g., '72000000' for IT services, '45000000' for construction). ## `daysBack` (type: `integer`): Only include notices published within this many days. Default is 30. ## `maxResults` (type: `integer`): Maximum number of procurement notices to return. ## `proxyConfiguration` (type: `object`): Proxy settings for accessing TED. ## Actor input object example ```json { "searchQuery": "software", "daysBack": 30, "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searchQuery": "software", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/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 = { "searchQuery": "software", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/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 '{ "searchQuery": "software", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call studio-amba/ted-eu-procurement-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/ted-eu-procurement-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TED EU Procurement Scraper — Public Tenders", "description": "Scrape EU public procurement notices from TED (Tenders Electronic Daily). Search by keyword, country, or CPV code. Extract tender titles, buyers, deadlines, estimated values, and award details. Covers all EU/EEA member states.", "version": "0.1", "x-build-id": "Dl9a9UyuqvK9EDJQ5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~ted-eu-procurement-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-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/studio-amba~ted-eu-procurement-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-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/studio-amba~ted-eu-procurement-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword to search for in procurement notices. Examples: 'software', 'construction', 'medical equipment'." }, "country": { "title": "Country Code", "type": "string", "description": "Filter by buyer country using ISO 2-letter code (e.g., 'BE', 'DE', 'FR'). Leave empty for all countries." }, "cpvCode": { "title": "CPV Code", "type": "string", "description": "Filter by Common Procurement Vocabulary code (e.g., '72000000' for IT services, '45000000' for construction)." }, "daysBack": { "title": "Days Back", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only include notices published within this many days. Default is 30.", "default": 30 }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of procurement notices to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for accessing TED." } } }, "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 } } } } } } } } } } ```