{ "openapi": "3.0.1", "info": { "title": "EU + UK Procurement Notices: TED, Contracts Finder, FTS", "description": "Returns public tenders and contract awards from TED (all EU countries), UK Contracts Finder and UK Find a Tender as one normalized dataset: title, buyer, country, CPV codes, deadline, estimated value, procedure, description and notice URL. Filter by date, keyword, CPV code, country and stage...", "version": "0.1", "x-build-id": "eci0nNDKhsV4AgWit" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cheering_unicorn~eu-uk-procurement-notices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cheering_unicorn-eu-uk-procurement-notices", "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/cheering_unicorn~eu-uk-procurement-notices/runs": { "post": { "operationId": "runs-sync-cheering_unicorn-eu-uk-procurement-notices", "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/cheering_unicorn~eu-uk-procurement-notices/run-sync": { "post": { "operationId": "run-sync-cheering_unicorn-eu-uk-procurement-notices", "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": { "sources": { "title": "Sources", "type": "array", "description": "Which portals to query. Leave empty for all three.", "items": { "type": "string", "enum": [ "ted", "uk-contracts-finder", "uk-find-a-tender" ], "enumTitles": [ "TED – Tenders Electronic Daily (EU)", "UK Contracts Finder (below-threshold and above)", "UK Find a Tender (above-threshold)" ] } }, "stages": { "title": "Stages", "type": "array", "description": "`tender` = open calls for competition, `award` = contract award notices, `planning` = prior information notices.", "items": { "type": "string", "enum": [ "tender", "award", "planning" ], "enumTitles": [ "Tender (calls for competition)", "Award (contract awards)", "Planning (prior information)" ] }, "default": [ "tender" ] }, "publishedAfter": { "title": "Published on or after", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD. Default: 3 days ago." }, "publishedBefore": { "title": "Published before", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD (exclusive)." }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep notices mentioning any of these words. TED: full-text search on the notice. UK: matched against title, description and buyer name.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "CPV codes or prefixes, for example `72` (IT services), `45` (construction), `33100000`. A prefix matches every code starting with it.", "items": { "type": "string" } }, "buyerCountries": { "title": "Buyer countries", "type": "array", "description": "ISO 3166-1 alpha-3 codes for TED, for example `DEU`, `FRA`, `NLD`. UK sources are included only if the list is empty or contains `GBR`.", "items": { "type": "string" } }, "maxNoticesPerSource": { "title": "Max notices per source", "minimum": 0, "type": "integer", "description": "0 = no limit.", "default": 1000 }, "maxScanPerSource": { "title": "Max releases scanned per UK source", "minimum": 100, "type": "integer", "description": "UK portals have no server-side keyword or CPV filter, so the Actor reads releases in the date window and filters them itself. This caps how many are read per source and stage (default 5000). Not charged; only matching notices are.", "default": 5000 }, "maxNotices": { "title": "Max notices in total", "minimum": 0, "type": "integer", "description": "Stop the run after this many notices. 0 = no limit. You pay only for notices saved.", "default": 0 } } }, "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 } } } } } } } } } }