{ "openapi": "3.0.1", "info": { "title": "UK Public Tenders Scraper - FTS + Contracts Finder", "description": "UK tenders, contract awards and pipeline notices from the official Find a Tender and Contracts Finder OCDS APIs: buyer contacts, CPV, value, deadline.", "version": "0.1", "x-build-id": "4XCx0chF4W7F0kK9p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/knotty_mistveil~uk-public-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-knotty_mistveil-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/knotty_mistveil~uk-public-tenders/runs": { "post": { "operationId": "runs-sync-knotty_mistveil-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/knotty_mistveil~uk-public-tenders/run-sync": { "post": { "operationId": "run-sync-knotty_mistveil-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": { "sources": { "title": "Sources", "type": "array", "description": "Which official feeds to read. Find a Tender carries above-threshold and Procurement Act 2023 notices; Contracts Finder carries below-threshold and legacy notices from England and other UK buyers. Default: both.", "items": { "type": "string", "enum": [ "find-a-tender", "contracts-finder" ], "enumTitles": [ "Find a Tender (find-tender.service.gov.uk)", "Contracts Finder (contractsfinder.service.gov.uk)" ] }, "default": [ "find-a-tender", "contracts-finder" ] }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 366, "type": "integer", "description": "Look-back window in days, ending now. Find a Tender is filtered on the notice's last update time, Contracts Finder on its publication time. Ignored when Date from / Date to are set.", "default": 3 }, "dateFrom": { "title": "Date from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Start of the window, YYYY-MM-DD (inclusive, from 00:00 UTC). Overrides Days back." }, "dateTo": { "title": "Date to", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "End of the window, YYYY-MM-DD (inclusive, to 23:59:59 UTC). Defaults to now." }, "keywords": { "title": "Keywords", "type": "array", "description": "Case-insensitive terms matched against the notice title, description and buyer name; a record is kept when any term matches. Empty = no keyword filter.", "items": { "type": "string" } }, "stages": { "title": "Notice stages", "type": "array", "description": "Keep only these stages: tender (new opportunities, including updates and cancellations), award (contract awards, including updates), planning (pipeline and early-engagement notices). Empty = all stages.", "items": { "type": "string", "enum": [ "tender", "award", "planning" ], "enumTitles": [ "Tender (opportunities)", "Award (contract awards)", "Planning (pipeline / early engagement)" ] }, "default": [ "tender", "award", "planning" ] }, "cpvPrefixes": { "title": "CPV code prefixes", "type": "array", "description": "Common Procurement Vocabulary codes or prefixes, 2 to 8 digits. 72 matches every IT-services code; 45 = construction, 33 = medical, 48 = software, 79 = business services, 85 = health and social care. A notice is kept when any of its CPV codes starts with any prefix. Empty = all.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "WARNING: this matches the contract's delivery area as well as the buyer's own address, so a UK-wide contract matches every region and you will see out-of-area buyers. Case-insensitive substrings matched against the buyer's region, town, postcode and country, the notice's delivery regions, and the UK nation implied by any NUTS code. Use names (\"West Midlands\", \"London\", \"Scotland\", \"England\", \"Manchester\") or NUTS/ITL codes (\"UKG\", \"UKM\"). For buyer location only, filter the output on buyerRegionName / buyerLocality / buyerPostcode. Empty = all regions.", "items": { "type": "string" } }, "minValue": { "title": "Minimum value", "minimum": 0, "maximum": 1000000000000, "type": "integer", "description": "Keep only notices whose estimated value (or award value when no estimate was published) is at least this amount in the notice currency, normally GBP. Notices without any value are dropped when this is set. 0 = no minimum.", "default": 0 }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many notices. You are charged per notice delivered. Newest notices come first: the two feeds are merged on publication date, so a small value returns whichever service published most recently rather than a fixed split, and anything smaller than the window's volume drops the OLDEST notices. Both services together publish roughly 500-620 releases per weekday, so a gap-free 3-day window needs about 2000.", "default": 500 } } }, "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 } } }, "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 } } } } } } } } } }