{ "openapi": "3.0.1", "info": { "title": "UK Public Tenders — Find a Tender + Contracts Finder", "description": "One reliable feed of UK public procurement notices. Merges Find a Tender and Contracts Finder (the Procurement Act 2023 split) into a single schema, with CPV, value, region and keyword filters and a new-notices-only mode.", "version": "1.0", "x-build-id": "pyxFlw08J7YMK7bUq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seralifatih~uk-public-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seralifatih-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/seralifatih~uk-public-tenders/runs": { "post": { "operationId": "runs-sync-seralifatih-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/seralifatih~uk-public-tenders/run-sync": { "post": { "operationId": "run-sync-seralifatih-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": "array", "description": "Return notices whose title or description contains ANY of these words or phrases (case-insensitive, matched from the start of a word, so 'cyber' finds 'cybersecurity'). Leave empty for no keyword filter.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes (prefix match)", "type": "array", "description": "Common Procurement Vocabulary codes, matched as a prefix. '72' = all IT services, '72212' = application software development, '45' = construction. A full 8-digit code such as 72000000 is treated as its division ('72'). Matches the notice's main and additional CPV codes, including those on items and lots.", "items": { "type": "string" } }, "publishedFrom": { "title": "Published from", "pattern": "^\\d{4}-\\d{2}-\\d{2}([Tt ]\\d{2}:\\d{2}(:\\d{2})?(\\.\\d+)?([Zz]|[+-]\\d{2}:?\\d{2})?)?$", "type": "string", "description": "Start of the publication window, as YYYY-MM-DD or an ISO-8601 datetime (UTC if no zone is given). Default: 24 hours before 'Published to'." }, "publishedTo": { "title": "Published to", "pattern": "^\\d{4}-\\d{2}-\\d{2}([Tt ]\\d{2}:\\d{2}(:\\d{2})?(\\.\\d+)?([Zz]|[+-]\\d{2}:?\\d{2})?)?$", "type": "string", "description": "End of the publication window, as YYYY-MM-DD (the whole day is included) or an ISO-8601 datetime. Default: now." }, "minValue": { "title": "Minimum value (GBP)", "minimum": 0, "type": "integer", "description": "Keep notices whose value range reaches at least this amount, e.g. 100000 for £100k+. Notices that state no value are excluded when a value filter is set." }, "maxValue": { "title": "Maximum value (GBP)", "minimum": 0, "type": "integer", "description": "Keep notices whose value range starts at or below this amount. Notices that state no value are excluded when a value filter is set." }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Which stages of procurement to return. Default: tender + planning (open opportunities and pipeline). Awards are opt-in: add 'award' (and 'contract', 'implementation') to also get awarded contracts, or list all five for everything. 'planning' = pipeline / early engagement, 'tender' = open opportunities, 'award' = awarded contracts, 'contract' = contract details, 'implementation' = contract delivery updates.", "items": { "type": "string", "enum": [ "planning", "tender", "award", "contract", "implementation" ], "enumTitles": [ "Planning / pipeline", "Tender (open opportunities)", "Award", "Contract", "Implementation" ] }, "default": [ "tender", "planning" ] }, "regions": { "title": "Regions", "type": "array", "description": "UK region names or NUTS codes, e.g. 'London', 'Scotland', 'UKI' (London), 'UKD7' (Merseyside). Names and NUTS codes are matched to each other, so 'London' also finds notices coded 'UKI31'. 'England' covers all nine English regions. Notices that only say 'UK' (nationwide) match only if you enter 'UK'.", "items": { "type": "string" } }, "buyers": { "title": "Buyers", "type": "array", "description": "Keep notices whose buyer (contracting authority) name contains ANY of these texts, case-insensitive, partial match: 'transport for london', 'nhs', 'council'. Notices with no buyer name never match.", "items": { "type": "string" } }, "onlyNew": { "title": "Only new since last run", "type": "boolean", "description": "Return only notices (and new versions of notices) not returned by a previous run with the same filters. State is kept in the named key-value store 'uk-public-tenders-state'. Combine with an Apify schedule for a daily feed. The first run behaves normally.", "default": false }, "sources": { "title": "Sources", "type": "array", "description": "Which services to read. Default: both.", "items": { "type": "string", "enum": [ "fts", "contracts_finder" ], "enumTitles": [ "Find a Tender", "Contracts Finder" ] }, "default": [ "fts", "contracts_finder" ] } } }, "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 } } } } } } } } } }