{ "openapi": "3.0.1", "info": { "title": "UK Tenders API: Contracts Finder & Find a Tender", "description": "UK public sector tenders, planned procurements and contract awards from Contracts Finder and Find a Tender, the official UK government procurement services, in one feed. Filter by keyword, CPV code, value and deadline. Optional tender alerts: only new notices since the last run.", "version": "0.0", "x-build-id": "3SehJkH1QgSMhlazq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tabulary~uk-public-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tabulary-uk-public-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/tabulary~uk-public-tenders/runs": { "post": { "operationId": "runs-sync-tabulary-uk-public-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/tabulary~uk-public-tenders/run-sync": { "post": { "operationId": "run-sync-tabulary-uk-public-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": "string", "description": "Optional. Comma-separated words or phrases, for example \"software, cyber security\". A notice matches when its title or description contains any of them (not case-sensitive). Leave empty to get every notice in the period.", "default": "" }, "stages": { "title": "Procurement stages", "uniqueItems": true, "type": "array", "description": "Which kinds of notices to return: open tenders (opportunities you can bid for), planned procurements (pipeline and market engagement) and awards (who won, for how much).", "items": { "type": "string", "enum": [ "tender", "planning", "award" ], "enumTitles": [ "Open tenders (opportunities)", "Planned procurements", "Awards and contracts" ] }, "default": [ "tender" ] }, "sources": { "title": "Sources", "uniqueItems": true, "type": "array", "description": "Contracts Finder carries mostly lower-value contracts in England; Find a Tender carries higher-value notices for the whole UK, including all Procurement Act 2023 notices. Results from both are merged, newest first.", "items": { "type": "string", "enum": [ "contracts-finder", "find-a-tender" ], "enumTitles": [ "Contracts Finder", "Find a Tender" ] }, "default": [ "contracts-finder", "find-a-tender" ] }, "publishedWithinDays": { "title": "Published in the last (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only notices published or updated in this many days, counting back from now.", "default": 3 }, "onlyOpen": { "title": "Only open tenders", "type": "boolean", "description": "Skip tender notices whose submission or participation deadline has passed, or that are cancelled, withdrawn or complete. A tender that states no deadline is kept only if the source marks it active. Has no effect on planned procurements or awards.", "default": true }, "onlyNewSinceLastRun": { "title": "Only new since the last run (tender alerts)", "type": "boolean", "description": "For scheduled runs. Remembers which notices earlier runs with the same filters returned, and returns only notices it has not delivered before, newest first, plus updated ones, so you pay only for new notices. The first run returns everything that matches. The memory is kept per set of filters (keywords, stages, sources, CPV, value) and covers at least the last 30 days.", "default": false }, "cpvPrefixes": { "title": "CPV code prefixes", "type": "array", "description": "Optional. Keep notices with at least one CPV code starting with any of these digits, for example 72 (IT services), 48 (software) or 45 (construction work).", "default": [], "items": { "type": "string" } }, "minValue": { "title": "Minimum value (GBP)", "minimum": 0, "type": "integer", "description": "Optional. Keep notices whose stated value is at least this amount. Notices that state no value are dropped when this is above 0.", "default": 0 }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many notices. Each notice is one billable dataset item.", "default": 10 } } }, "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 } } } } } } } } } }