{ "openapi": "3.0.1", "info": { "title": "Public Tenders UK & EU: Find a Tender, Contracts Finder, TED", "description": "Public procurement feed for UK and EU tenders: new opportunity notices from official Find a Tender, Contracts Finder and TED APIs in one normalised schema. Filter by keyword, CPV, country, value and date; 'only new' skips seen notices. No awards. Contact details removed (best effort). Free demo.", "version": "0.1", "x-build-id": "zNbBk6AU7IkBJUTon" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lineagersiui~public-tender-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lineagersiui-public-tender-feed", "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/lineagersiui~public-tender-feed/runs": { "post": { "operationId": "runs-sync-lineagersiui-public-tender-feed", "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/lineagersiui~public-tender-feed/run-sync": { "post": { "operationId": "run-sync-lineagersiui-public-tender-feed", "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": "A notice matches if ANY keyword appears (case-insensitive) in its title or description, e.g. software, cleaning, solar. TED is also searched with its own full-text search; keywords it cannot use (e.g. C++) are matched only locally. Up to 20.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes or prefixes", "type": "array", "description": "Common Procurement Vocabulary codes. Trailing zeros mean the whole branch: 72000000 (or 72) matches all IT services, 45233120 matches that code and its sub-codes. Up to 30.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Buyer countries as ISO 3166 two-letter codes: GB (or UK) for the UK sources; DE, FR, IE, NL, PL, IT, ES and other EU/EEA codes for TED. Empty means all countries.", "items": { "type": "string" } }, "publishedSince": { "title": "Published since", "pattern": "^(\\d{4}-\\d{2}-\\d{2}.*|[-+]?\\s*\\d{1,4}\\s*(hour|day|week|month)s?( ago)?)?$", "type": "string", "description": "Only notices published on or after this date: a date such as 2026-10-20, or a relative period such as 7 days, 2 weeks or 48 hours. Default 7 days; at most 90 days back." }, "minValue": { "title": "Minimum value", "minimum": 0, "type": "integer", "description": "Only notices with an estimated value at or above this amount, in the notice's own currency (GBP for UK, usually EUR for TED; no currency conversion)." }, "maxValue": { "title": "Maximum value", "minimum": 0, "type": "integer", "description": "Only notices with an estimated value at or below this amount, in the notice's own currency." }, "includeNoValue": { "title": "Keep notices without a published value", "type": "boolean", "description": "When a minimum or maximum value is set, notices that publish no value are left out unless this is on. Many notices publish no value.", "default": false }, "includeClosed": { "title": "Include notices whose deadline has passed", "type": "boolean", "description": "Off by default: notices with a tender deadline in the past are left out.", "default": false }, "onlyNew": { "title": "Only new notices since my last run", "type": "boolean", "description": "Remembers which notices this exact filter set already returned (in a key-value store named public-tender-feed-state in your account) and returns only unseen ones. Notices skipped as already seen are not billed. Ideal for scheduled runs.", "default": false }, "maxNotices": { "title": "Maximum notices per run", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper limit of notices returned (and billed) in one run. When the limit cuts the results, the sources share it in turn; the output is then sorted newest first. 1 to 1,000.", "default": 200 }, "sources": { "title": "Sources", "type": "array", "description": "Which official sources to query: fts (Find a Tender, UK above threshold), cf (Contracts Finder, UK below threshold), ted (EU). Empty means all three. Countries also select sources: GB queries only the UK sources; EU codes query only TED.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }