{ "openapi": "3.0.1", "info": { "title": "UK Contracts Finder - Tenders and Contract Awards", "description": "Search UK public sector tenders, planning notices and contract awards from the official Contracts Finder OCDS API. Filter by keyword, CPV code, value, buyer, region and date. No key needed.", "version": "0.1", "x-build-id": "9hLQymZsEuZ2dc7Xc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/staymeter-labs~uk-contracts-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-staymeter-labs-uk-contracts-finder", "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/staymeter-labs~uk-contracts-finder/runs": { "post": { "operationId": "runs-sync-staymeter-labs-uk-contracts-finder", "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/staymeter-labs~uk-contracts-finder/run-sync": { "post": { "operationId": "run-sync-staymeter-labs-uk-contracts-finder", "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": { "stages": { "title": "Notice stages", "type": "array", "description": "tender = opportunities open for bids, award = awarded contracts, planning = early market engagement and pipeline notices.", "items": { "type": "string", "enum": [ "tender", "award", "planning" ] }, "default": [ "tender" ] }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep 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": "Common Procurement Vocabulary codes. A shorter prefix matches the whole branch (e.g. 72 = IT services, 45 = construction, 85 = health and social care).", "items": { "type": "string" } }, "buyerNames": { "title": "Buyer name contains", "type": "array", "description": "Keep notices whose buyer name contains ANY of these texts, e.g. NHS, County Council.", "items": { "type": "string" } }, "regions": { "title": "Delivery region contains", "type": "array", "description": "Keep notices delivered in a matching region, e.g. London, Scotland, North West. Notices that do not state a region are dropped when this is set.", "items": { "type": "string" } }, "minValue": { "title": "Minimum value (GBP)", "minimum": 0, "type": "integer", "description": "Keep notices whose value is at least this. Notices with no published value are dropped when this is set." }, "maxValue": { "title": "Maximum value (GBP)", "minimum": 0, "type": "integer", "description": "Keep notices whose value is at most this. Notices with no published value are dropped when this is set." }, "openOnly": { "title": "Open for bids only", "type": "boolean", "description": "Only tender notices whose submission deadline has not passed (or has no deadline).", "default": false }, "smeOnly": { "title": "Suitable for SMEs only", "type": "boolean", "description": "Only notices flagged as suitable for small and medium-sized enterprises.", "default": false }, "sinceDays": { "title": "Published in the last N days", "minimum": 0, "type": "integer", "description": "Ignored if Since date is set. Use with a schedule for daily monitoring.", "default": 7 }, "sinceDate": { "title": "Since date", "type": "string", "description": "Only notices published on or after this date (YYYY-MM-DD)." }, "untilDate": { "title": "Until date", "type": "string", "description": "Only notices published on or before this date (YYYY-MM-DD). Default: today." }, "maxItems": { "title": "Maximum notices", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many matching notices.", "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 } } } } } } } } } }