# EU TED Procurement Watchlist Monitor (`orbiscribe/eu-ted-procurement-monitor`) Actor Monitor EU Tenders Electronic Daily notices through the official TED Search API. Emit structured tender, contract notice, buyer, CPV, country, deadline, and source-link records. - **URL**: https://apify.com/orbiscribe/eu-ted-procurement-monitor.md - **Developed by:** [Orbiscribe Labs](https://apify.com/orbiscribe) (community) - **Categories:** Business, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $4.00 / 1,000 eu ted notice matches 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 ## EU TED Procurement Watchlist Monitor Monitor EU Tenders Electronic Daily procurement notices through the official TED Search API and emit structured opportunity records for scheduled bid alerts, market research, and procurement intelligence. This Actor is for government-contracting teams, proposal shops, consultants, market researchers, agencies, and vendors who need repeatable EU tender watchlists without scraping the TED website. ### What It Does Provide TED expert queries and optional filters: - CPV codes or CPV prefixes - place-of-performance country codes - publication date windows - buyer or topic terms through TED expert search - notice type filters through TED expert search The Actor calls the official public TED API, normalizes multilingual notice fields, extracts buyer names, countries, CPV codes, deadlines, and source links, then compares against previous runs so schedules can emit only new notices. ### Output Each result is one matched TED notice: ```json { "recordType": "eu_ted_procurement_notice", "changeType": "new_notice", "publicationNumber": "300001-2026", "title": "France - IT services - Cloud migration support for public agency", "buyerNames": ["Demo Public Agency"], "publicationDate": "2026-05-12+02:00", "deadlineDate": "2026-06-15+02:00", "countries": ["FRA"], "cpvCodes": ["72000000"], "noticeType": "cn-standard", "sourceUrl": "https://ted.europa.eu/en/notice/-/detail/300001-2026" } ```` The run also stores: - `RUN_SUMMARY` with source status, counts, and errors - `NOTICE_EXPORT` with all emitted notice records - `NEW_ONLY` for scheduled alert workflows - `BUYER_BRIEF` for a short reviewable report - `SLACK_ALERTS` for webhook-style notification payloads ### Why Use This Instead Of A Broad Tender Scraper? Broad tender scrapers are useful when you want everything. This Actor is built for watchlists: 1. Define one or more TED expert queries. 2. Add CPV and country filters if needed. 3. Schedule the Actor daily or weekly. 4. Send new matches to Slack, email, Sheets, CRM, or a bid pipeline. 5. Review the TED source notice before making bid decisions. The Actor uses the official TED API and does not need private credentials. ### Pricing Dry runs are free. Live runs use Pay per Event: - first 25 live matches are free for Apify free-plan users - then `$0.004` per emitted TED notice match This charges only when a notice matches the user's watchlist and is emitted. ### Limits And Compliance TED notices can contain multilingual, lot-level, repeated, or missing fields. Deadline and buyer fields can vary by notice form. Verify bid-critical decisions on the source TED notice and procurement documents. This Actor is not procurement, legal, or bid advice. ### Example Input ```json { "queries": ["publication-date >= 20260501"], "cpvCodes": ["72000000"], "countries": ["FRA", "DEU", "ESP"], "maxResultsPerQuery": 25, "compareToPreviousRun": true, "includeUnchanged": false, "dryRun": false } ``` ### Good Use Cases - EU procurement opportunity watchlists - CPV-specific tender monitoring - country-specific bid alerts - market sizing for public-sector categories - agency reports for suppliers and proposal teams - official-source procurement datasets for BI and AI workflows ### Local Development ```bash npm install npm test npm run build APIFY_LOCAL_STORAGE_DIR=./storage APIFY_INPUT='{"dryRun":true}' npm start ``` # Actor input Schema ## `queries` (type: `array`): TED expert search queries. Example: publication-date >= 20260501 AND classification-cpv = 72000000 ## `cpvCodes` (type: `array`): Optional CPV prefixes or exact codes to keep, such as 72000000 for IT services. ## `countries` (type: `array`): Optional TED country codes to keep, such as FRA, DEU, ESP, POL, ROU. ## `maxResultsPerQuery` (type: `integer`): Maximum TED notices requested per expert query. ## `includeUnchanged` (type: `boolean`): Emit unchanged notices. Usually leave this off for scheduled alert workflows. ## `compareToPreviousRun` (type: `boolean`): Store publication numbers and mark new or unchanged notices on later scheduled runs. ## `snapshotStoreName` (type: `string`): Key-value store name for previous TED publication numbers. ## `dryRun` (type: `boolean`): Emit deterministic demo TED notices without calling the TED API or charging custom pay-per-event events. ## Actor input object example ```json { "queries": [ "publication-date >= 20260501" ], "cpvCodes": [], "countries": [], "maxResultsPerQuery": 25, "includeUnchanged": false, "compareToPreviousRun": true, "snapshotStoreName": "eu-ted-procurement-monitor-snapshots", "dryRun": true } ``` # Actor output Schema ## `results` (type: `string`): No description ## `noticeExport` (type: `string`): No description ## `newOnly` (type: `string`): No description ## `buyerBrief` (type: `string`): No description ## `runSummary` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("orbiscribe/eu-ted-procurement-monitor").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 = {} # Run the Actor and wait for it to finish run = client.actor("orbiscribe/eu-ted-procurement-monitor").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 '{}' | apify call orbiscribe/eu-ted-procurement-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=orbiscribe/eu-ted-procurement-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EU TED Procurement Watchlist Monitor", "description": "Monitor EU Tenders Electronic Daily notices through the official TED Search API. Emit structured tender, contract notice, buyer, CPV, country, deadline, and source-link records.", "version": "0.1", "x-build-id": "hFkQqJXat5xSmSg9Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/orbiscribe~eu-ted-procurement-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-orbiscribe-eu-ted-procurement-monitor", "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/orbiscribe~eu-ted-procurement-monitor/runs": { "post": { "operationId": "runs-sync-orbiscribe-eu-ted-procurement-monitor", "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/orbiscribe~eu-ted-procurement-monitor/run-sync": { "post": { "operationId": "run-sync-orbiscribe-eu-ted-procurement-monitor", "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": { "queries": { "title": "TED expert queries", "type": "array", "description": "TED expert search queries. Example: publication-date >= 20260501 AND classification-cpv = 72000000", "default": [ "publication-date >= 20260501" ] }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Optional CPV prefixes or exact codes to keep, such as 72000000 for IT services.", "default": [] }, "countries": { "title": "Countries", "type": "array", "description": "Optional TED country codes to keep, such as FRA, DEU, ESP, POL, ROU.", "default": [] }, "maxResultsPerQuery": { "title": "Max results per query", "minimum": 1, "maximum": 250, "type": "integer", "description": "Maximum TED notices requested per expert query.", "default": 25 }, "includeUnchanged": { "title": "Include unchanged", "type": "boolean", "description": "Emit unchanged notices. Usually leave this off for scheduled alert workflows.", "default": false }, "compareToPreviousRun": { "title": "Compare to previous run", "type": "boolean", "description": "Store publication numbers and mark new or unchanged notices on later scheduled runs.", "default": true }, "snapshotStoreName": { "title": "Snapshot store name", "type": "string", "description": "Key-value store name for previous TED publication numbers.", "default": "eu-ted-procurement-monitor-snapshots" }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Emit deterministic demo TED notices without calling the TED API or charging custom pay-per-event events.", "default": true } } }, "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 } } } } } } } } } } ```