{ "openapi": "3.0.1", "info": { "title": "UK Public Tenders: Find a Tender + Contracts Finder", "description": "Search UK public sector tenders and contract awards from Find a Tender and Contracts Finder in one run. Filter by keyword, CPV code, value, deadline and SME suitability. Buyer, value, deadline, CPV, awarded suppliers and notice links. Alert mode returns only new notices. No API key needed.", "version": "0.1", "x-build-id": "2m72dvB4oLGqwlAzO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/frank0309~uk-public-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-frank0309-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/frank0309~uk-public-tenders/runs": { "post": { "operationId": "runs-sync-frank0309-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/frank0309~uk-public-tenders/run-sync": { "post": { "operationId": "run-sync-frank0309-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": "Notices whose title or description contains any of these words or phrases (case-insensitive). Leave empty for all.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "CPV codes, e.g. 72000000 (IT services) or 45000000 (construction). A parent code also matches its sub-codes.", "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "Find a Tender carries higher-value notices across the UK; Contracts Finder carries lower-value notices, mostly in England. Defaults to both.", "items": { "type": "string", "enum": [ "findATender", "contractsFinder" ], "enumTitles": [ "Find a Tender", "Contracts Finder" ] }, "default": [ "findATender", "contractsFinder" ] }, "stages": { "title": "Stages", "type": "array", "description": "Tender = open opportunities; Award = contracts awarded (with suppliers); Planning = early market engagement and pipeline notices. Defaults to tender.", "items": { "type": "string", "enum": [ "tender", "award", "planning" ], "enumTitles": [ "Tender (opportunities)", "Award (winners)", "Planning (pipeline)" ] }, "default": [ "tender" ] }, "daysBack": { "title": "Published in the last N days", "minimum": 1, "maximum": 90, "type": "integer", "description": "How far back to look. Both services publish a few hundred notices a day, so longer windows take longer to scan.", "default": 7 }, "openForTendersOnly": { "title": "Only notices still open for tenders", "type": "boolean", "description": "Skip notices whose tender deadline has passed.", "default": false }, "minValue": { "title": "Minimum value (GBP)", "minimum": 0, "type": "integer", "description": "Skip notices with a smaller (or no) estimated value." }, "smeSuitableOnly": { "title": "Exclude notices marked unsuitable for SMEs", "type": "boolean", "description": "Contracts Finder marks each notice as suitable or not for small businesses; notices without this flag are kept.", "default": false }, "onlyNewSinceLastRun": { "title": "Only new notices (alert mode)", "type": "boolean", "description": "Return only notices that earlier runs with the same filters have not returned. Schedule the Actor daily to get a feed of new UK tenders. The first run returns everything that matches.", "default": false }, "maxItems": { "title": "Maximum notices", "minimum": 1, "type": "integer", "description": "Stop after saving this many notices.", "default": 100 }, "maxScannedPerSource": { "title": "Maximum notices to scan per source", "minimum": 100, "type": "integer", "description": "Safety limit on how many notices are read from each source before filtering. Find a Tender publishes about 400 notices a day. You are only charged for notices saved.", "default": 10000 } } }, "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 } } } } } } } } } }