{ "openapi": "3.0.1", "info": { "title": "EU Tenders Watch: New TED Notices, CPV Labels & EUR Values", "description": "Build a daily TED shortlist with labelled CPV sectors, EUR values where published, and named watches that skip notices you've already seen. Filter by country, CPV code and keyword.", "version": "1.0", "x-build-id": "NXWQDENzHF29DU4PA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/taskfold~ted-tenders-watch/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-taskfold-ted-tenders-watch", "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/taskfold~ted-tenders-watch/runs": { "post": { "operationId": "runs-sync-taskfold-ted-tenders-watch", "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/taskfold~ted-tenders-watch/run-sync": { "post": { "operationId": "run-sync-taskfold-ted-tenders-watch", "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": { "cpvCodes": { "title": "CPV codes (what is being bought)", "type": "array", "description": "8-digit CPV codes. A code with trailing zeros also matches everything below it: 72000000 covers all IT services (72xxxxxx). Leave empty for all sectors.", "items": { "type": "string" } }, "countries": { "title": "Buyer countries", "type": "array", "description": "Only tenders from buyers in these countries. Leave empty for all countries.", "items": { "type": "string", "enum": [ "AT", "BE", "BG", "HR", "CY", "CZ", "DK", "EE", "FI", "FR", "DE", "GR", "HU", "IE", "IT", "LV", "LT", "LU", "MT", "NL", "PL", "PT", "RO", "SK", "SI", "ES", "SE", "IS", "LI", "NO", "CH", "GB", "AL", "BA", "ME", "MK", "RS", "TR", "UA", "MD", "XK" ], "enumTitles": [ "Austria (AT)", "Belgium (BE)", "Bulgaria (BG)", "Croatia (HR)", "Cyprus (CY)", "Czechia (CZ)", "Denmark (DK)", "Estonia (EE)", "Finland (FI)", "France (FR)", "Germany (DE)", "Greece (GR)", "Hungary (HU)", "Ireland (IE)", "Italy (IT)", "Latvia (LV)", "Lithuania (LT)", "Luxembourg (LU)", "Malta (MT)", "Netherlands (NL)", "Poland (PL)", "Portugal (PT)", "Romania (RO)", "Slovakia (SK)", "Slovenia (SI)", "Spain (ES)", "Sweden (SE)", "Iceland (IS)", "Liechtenstein (LI)", "Norway (NO)", "Switzerland (CH)", "United Kingdom (GB)", "Albania (AL)", "Bosnia and Herzegovina (BA)", "Montenegro (ME)", "North Macedonia (MK)", "Serbia (RS)", "Turkey (TR)", "Ukraine (UA)", "Moldova (MD)", "Kosovo (XK)" ] } }, "keywords": { "title": "Keywords", "type": "array", "description": "Words or phrases to look for, for example: cloud, cybersecurity. Works in any language TED has.", "items": { "type": "string" } }, "keywordMode": { "title": "Keyword match", "enum": [ "any", "all" ], "type": "string", "description": "'Any' finds notices with at least one keyword. 'All' needs every keyword.", "default": "any" }, "keywordScope": { "title": "Search keywords in", "enum": [ "fullText", "title" ], "type": "string", "description": "'Full text' is wider. 'Title only' is stricter and gives fewer false hits.", "default": "fullText" }, "noticeStage": { "title": "Notice type", "enum": [ "contracts", "awards", "all" ], "type": "string", "description": "Contracts = open calls you can bid on. Awards = who won. All = everything.", "default": "contracts" }, "daysBack": { "title": "Published in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Used when 'Published from' is empty. 2 means today and the 2 days before.", "default": 2 }, "publishedFrom": { "title": "Published from (optional)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "First publication date, format 2026-10-25. Overrides 'last N days'." }, "publishedTo": { "title": "Published to (optional)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Last publication date, format 2026-10-25. Empty means today." }, "minValueEur": { "title": "Minimum value (EUR)", "minimum": 0, "type": "integer", "description": "Keep tenders worth at least this much. Other currencies are converted with the European Central Bank rate of the run day." }, "maxValueEur": { "title": "Maximum value (EUR)", "minimum": 0, "type": "integer", "description": "Keep tenders worth at most this much." }, "includeUnknownValue": { "title": "Keep tenders with no stated value", "type": "boolean", "description": "Many notices do not state a value. Turn off to drop them when you use a value filter.", "default": true }, "sinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "Remembers what you already got and returns only new notices. Best for scheduled runs.", "default": false }, "stateKey": { "title": "Watch name (for 'since last run')", "type": "string", "description": "Use a different name for each watch you schedule, so they do not share memory.", "default": "default" }, "includeDescription": { "title": "Include description text", "type": "boolean", "description": "Adds the short procurement description (original language). Rows get larger.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "You pay $0.003 per result, so this is also your cost cap. Default 100 (about $0.31 with the start fee). Hard limit 5,000 per run (at most about $15). Newest notices come first.", "default": 100 }, "advancedQuery": { "title": "Advanced TED query (optional)", "type": "string", "description": "A TED expert-search condition added with AND, for example: contract-nature=services. See docs.ted.europa.eu." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }