{ "openapi": "3.0.1", "info": { "title": "Tender Feed API: EU TED, UK Find a Tender & Contracts Finder", "description": "Scrape EU and UK public tenders in one clean feed: TED, Find a Tender and Contracts Finder via official APIs. Filter by keyword, country, CPV and date; get buyer, value, deadline, lots and links. Watch mode returns only new notices. $2.50 per 1,000.", "version": "0.1", "x-build-id": "vZvykeFwh2fHfEWag" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/infocomp~eu-uk-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-infocomp-eu-uk-tenders", "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/infocomp~eu-uk-tenders/runs": { "post": { "operationId": "runs-sync-infocomp-eu-uk-tenders", "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/infocomp~eu-uk-tenders/run-sync": { "post": { "operationId": "run-sync-infocomp-eu-uk-tenders", "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": "Optional. A notice matches if it contains ANY of these words or phrases. TED searches the full notice text in every language. UK notices are matched on title, description, buyer and lot titles. Leave empty for all notices.", "default": [], "items": { "type": "string" } }, "countries": { "title": "Buyer countries", "type": "array", "description": "Optional ISO codes, 2 or 3 letters, e.g. DE, FRA, IE, GB. Include GB to keep the UK sources. Leave empty for all countries.", "default": [], "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Optional CPV sector codes. Sub-codes are included, so 72000000 (or just 72) covers all IT services and 45 covers all construction work.", "default": [], "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "TED is the EU Official Journal tender database (EU, EEA and more). Find a Tender is the UK's service for higher-value notices. Contracts Finder lists UK notices of £12,000 or more.", "items": { "type": "string", "enum": [ "ted", "find-a-tender", "contracts-finder" ], "enumTitles": [ "TED (EU)", "Find a Tender (UK)", "Contracts Finder (UK)" ] }, "default": [ "ted", "find-a-tender", "contracts-finder" ] }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Tender = open calls for bids (contract notices). Award = contract award notices. Planning = prior information notices.", "items": { "type": "string", "enum": [ "tender", "award", "planning" ], "enumTitles": [ "Open tenders", "Contract awards", "Planning / prior information" ] }, "default": [ "tender" ] }, "daysBack": { "title": "Published in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Used when 'Published from' is empty.", "default": 7 }, "dateFrom": { "title": "Published from", "type": "string", "description": "Optional start date (YYYY-MM-DD). Overrides 'last N days'." }, "dateTo": { "title": "Published to", "type": "string", "description": "Optional end date (YYYY-MM-DD). Defaults to today." }, "maxResults": { "title": "Max notices", "minimum": 1, "maximum": 15000, "type": "integer", "description": "Stop after this many notices in total. Sources are mixed newest first, so each one is represented. Your maximum cost per run also applies.", "default": 20 }, "onlyNewNotices": { "title": "Watch mode: only new notices", "type": "boolean", "description": "Remembers the notices already returned (per state key) and saves only new ones. Use it with a daily schedule for tender alerts. Notices seen before are not charged.", "default": false }, "stateKey": { "title": "Watch-mode state key", "type": "string", "description": "Name for this watch list. Use a different key for each saved search.", "default": "default" }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Short notice description (up to 1,000 characters, contact details removed).", "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 }, "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 } } } } } } } } } }