{ "openapi": "3.0.1", "info": { "title": "UK Public Tenders", "description": "Find open UK public sector tenders and upcoming contracts from the official Contracts Finder API. Filter by keyword, CPV, region, value and SME suitability.", "version": "0.1", "x-build-id": "mHHTZMa77gvYHlyvF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/avorelis~uk-public-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-avorelis-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/avorelis~uk-public-tenders/runs": { "post": { "operationId": "runs-sync-avorelis-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/avorelis~uk-public-tenders/run-sync": { "post": { "operationId": "run-sync-avorelis-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", "maxLength": 200, "type": "string", "description": "Words that must all appear in the tender title, description or buyer name, case-insensitive. Example: \"cleaning services\" or \"software\". Leave empty for all tenders." }, "cpvCodes": { "title": "CPV codes (industry)", "maxItems": 50, "type": "array", "description": "CPV industry codes with 2 to 8 digits. Shorter codes include all sub-categories: \"72\" = IT services, \"45\" = construction work, \"90910000\" = cleaning. A tender matches if any of its CPV codes starts with one of yours.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "UK regions where the contract is delivered, for example London or Scotland. Leave empty for the whole UK. Tenders marked as open to any region are included unless you switch off the next option.", "items": { "type": "string", "enum": [ "London", "South East", "South West", "East of England", "East Midlands", "West Midlands", "North East", "North West", "Yorkshire and The Humber", "Scotland", "Wales", "Northern Ireland" ] } }, "includeNationwide": { "title": "Include tenders open to any region", "type": "boolean", "description": "When regions are selected, also return tenders the buyer marked as deliverable in any region. Has no effect when no region is selected.", "default": true }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "\"open\" = live opportunities you can bid on now. \"pipeline\" = contracts the buyer plans to tender soon, useful for early preparation. Default: open only.", "items": { "type": "string", "enum": [ "open", "pipeline" ], "enumTitles": [ "Open opportunities", "Upcoming pipeline contracts" ] }, "default": [ "open" ] }, "minValue": { "title": "Minimum contract value (GBP)", "minimum": 0, "maximum": 100000000000, "type": "integer", "description": "Only tenders whose estimated value reaches at least this amount in pounds. Tenders without a published value are excluded when this filter is set." }, "maxValue": { "title": "Maximum contract value (GBP)", "minimum": 0, "maximum": 100000000000, "type": "integer", "description": "Only tenders whose estimated value starts at or below this amount in pounds. Useful for small businesses. Tenders without a published value are excluded when set." }, "smeSuitableOnly": { "title": "Only tenders suitable for SMEs", "type": "boolean", "description": "Return only tenders the buyer marked as suitable for small and medium-sized enterprises.", "default": false }, "publishedWithinDays": { "title": "Published within the last days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only tenders published in the last N days, for example 1 for a daily alert or 7 for a weekly monitor. Leave empty for all open tenders." }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Stop after this many tenders. Each delivered tender is charged once, so this also caps the cost of a run.", "default": 100 } } }, "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 } } } } } } } } } }