# EU TED Procurement Deadline & Change Monitor (`immense_insulator/ted-procurement-change-monitor`) Actor Filter official EU procurement notices and emit NEW/CHANGED events with deadline deltas. - **URL**: https://apify.com/immense\_insulator/ted-procurement-change-monitor.md - **Developed by:** [xinyao a](https://apify.com/immense_insulator) (community) - **Categories:** Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $3.00 / 1,000 procurement change events 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 ## EU TED Procurement Deadline & Change Monitor An Apify Actor that turns the official, keyless EU **Tenders Electronic Daily (TED) Search API v3** into a structured event feed. ### Verified output sample - [View the procurement event sample and field guide](https://tools.axinyao.com/eu-ted-tender-deadline-change-monitor) - [Download sample CSV](https://tools.axinyao.com/static/data-products/ted-procurement/sample.csv) - [Download sample JSON](https://tools.axinyao.com/static/data-products/ted-procurement/sample.json) The sample comes from a verified run against the official TED API and preserves the official notice URL for provenance. It is intentionally not another “download some tenders” wrapper. Reuse the same `watchKey` on a schedule and it emits: - `NEW` procurement procedures on the first observation; - `CHANGED` procedures when deadlines, values, CPV codes, countries, buyers, title, notice type, or official change text changes; - `previousValues` and `changedFields`, suitable for Slack/email/webhook/CRM automation; - normalized deadlines, earliest deadline, and days remaining; - JSON/JSONL/CSV/Excel/XML/RSS export through Apify datasets. ### Data source and compliance The Actor calls `POST https://api.ted.europa.eu/v3/notices/search` directly. The official documentation says this Search API provides published notices for reuse/analysis and **does not require authentication**. It uses no browser, login, cookie, personal profile data, or paid proxy. Records are public procurement notices and buyer organisations. Official docs: ### Example input ```json { "keywords": ["cybersecurity", "cloud"], "countries": ["DEU", "FRA", "NLD"], "cpvCodes": ["72"], "publishedFrom": "2026-07-01", "publishedTo": "2026-07-23", "deadlineTo": "2026-10-31", "watchKey": "eu-cloud-opportunities", "monitorByProcedure": true, "maxItems": 250 } ```` Dates default to the last seven days through today. `cpvCodes` accepts prefixes. Keyword matching is case-insensitive and matches title, buyer, and official change description. ### Scheduling and change semantics 1. Create one task per watchlist and give it a stable, unique `watchKey`. 2. Schedule daily or hourly. 3. Connect the run-finished webhook or an integration to consume only dataset events. 4. Keep `monitorByProcedure=true`: when TED publishes a correction/new notice for an existing procedure, the latest publication is compared with the previous stored procedure snapshot. The state is stored in the default key-value store as `TED_STATE_`. A first run emits all matches as `NEW`. Identical subsequent runs emit nothing unless `emitUnchanged=true`. **Important:** `maxItems` limits *matched* records, so selective client-side filters can require multiple official API pages. Very broad historical queries should use a larger `maxItems` or a narrow TED `expertQuery`. ### Output excerpt ```json { "eventType": "CHANGED", "publicationNumber": "497792-2026", "procedureIdentifier": "e8ef638a-22e9-4113-baf6-def0457776e7", "title": "Laboratory equipment", "buyerNames": ["Example buyer"], "cpvCodes": ["38434540"], "countries": ["LTU"], "deadlineDates": ["2026-08-25"], "earliestDeadline": "2026-08-25", "changedFields": ["deadlineDates"], "previousValues": {"deadlineDates": ["2026-08-14"]}, "sourceUrl": "https://ted.europa.eu/en/notice/497792-2026" } ``` ### Local development ```bash python -m venv .venv . .venv/bin/activate pip install -r requirements-dev.txt pytest -q RUN_LIVE=1 pytest -q -m live ``` Run as an Actor locally (Apify local storage): ```bash APIFY_INPUT='{"publishedFrom":"2026-07-20","publishedTo":"2026-07-23","maxItems":5,"watchKey":"demo"}' python -m src.main ``` ### Limits - TED’s field/page budget requires small pages; this Actor handles paging automatically. - Deadline fields differ across old and current TED form generations; output combines three official deadline fields and deduplicates dates. - Procedure mode deliberately outputs the latest notice per procedure. Disable it when every notice version must be a separate event. - This is procurement intelligence, not legal advice. Always follow the source URL before bidding. # Actor input Schema ## `keywords` (type: `array`): Match any keyword in title, buyer, or official change description. ## `countries` (type: `array`): Examples: DEU, FRA, POL. ## `cpvCodes` (type: `array`): Full codes or prefixes, e.g. 72 for IT or 72000000. ## `publishedFrom` (type: `string`): YYYY-MM-DD. Defaults to seven days ago. ## `publishedTo` (type: `string`): YYYY-MM-DD. Defaults to today. ## `deadlineFrom` (type: `string`): Keep notices with at least one deadline on/after this date. ## `deadlineTo` (type: `string`): Keep notices with at least one deadline on/before this date. ## `expertQuery` (type: `string`): Optional: overrides the generated publication-date query. Use official TED expert-search syntax. ## `preferredLanguage` (type: `string`): TED ISO 639-2 code. ## `maxItems` (type: `integer`): Maximum number of matched procurement notices processed in one run. ## `watchKey` (type: `string`): Stable name for this filter. Reuse it on scheduled runs to detect changes. ## `monitorByProcedure` (type: `boolean`): Recommended. A correction/new notice for the same procedure becomes CHANGED instead of NEW. ## `emitUnchanged` (type: `boolean`): Normally false to create an automation-friendly delta feed. ## Actor input object example ```json { "keywords": [], "countries": [], "cpvCodes": [], "preferredLanguage": "eng", "maxItems": 100, "watchKey": "default", "monitorByProcedure": true, "emitUnchanged": false } ``` # 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("immense_insulator/ted-procurement-change-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("immense_insulator/ted-procurement-change-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 immense_insulator/ted-procurement-change-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=immense_insulator/ted-procurement-change-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EU TED Procurement Deadline & Change Monitor", "description": "Filter official EU procurement notices and emit NEW/CHANGED events with deadline deltas.", "version": "0.1", "x-build-id": "P5Mobs4s8qnoJFNhF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/immense_insulator~ted-procurement-change-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-immense_insulator-ted-procurement-change-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/immense_insulator~ted-procurement-change-monitor/runs": { "post": { "operationId": "runs-sync-immense_insulator-ted-procurement-change-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/immense_insulator~ted-procurement-change-monitor/run-sync": { "post": { "operationId": "run-sync-immense_insulator-ted-procurement-change-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Match any keyword in title, buyer, or official change description.", "default": [], "items": { "type": "string" } }, "countries": { "title": "Performance countries (ISO-3)", "type": "array", "description": "Examples: DEU, FRA, POL.", "default": [], "items": { "type": "string" } }, "cpvCodes": { "title": "CPV code prefixes", "type": "array", "description": "Full codes or prefixes, e.g. 72 for IT or 72000000.", "default": [], "items": { "type": "string" } }, "publishedFrom": { "title": "Published from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD. Defaults to seven days ago." }, "publishedTo": { "title": "Published to", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD. Defaults to today." }, "deadlineFrom": { "title": "Deadline from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep notices with at least one deadline on/after this date." }, "deadlineTo": { "title": "Deadline to", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep notices with at least one deadline on/before this date." }, "expertQuery": { "title": "Advanced TED expert query", "type": "string", "description": "Optional: overrides the generated publication-date query. Use official TED expert-search syntax." }, "preferredLanguage": { "title": "Preferred language", "type": "string", "description": "TED ISO 639-2 code.", "default": "eng" }, "maxItems": { "title": "Maximum matched records", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of matched procurement notices processed in one run.", "default": 100 }, "watchKey": { "title": "Watch key", "type": "string", "description": "Stable name for this filter. Reuse it on scheduled runs to detect changes.", "default": "default" }, "monitorByProcedure": { "title": "Track changes by procurement procedure", "type": "boolean", "description": "Recommended. A correction/new notice for the same procedure becomes CHANGED instead of NEW.", "default": true }, "emitUnchanged": { "title": "Also emit unchanged records", "type": "boolean", "description": "Normally false to create an automation-friendly delta feed.", "default": false } } }, "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 } } } } } } } } } } ```