{ "openapi": "3.0.1", "info": { "title": "UK Tenders Scraper: Find a Tender and Contracts Finder Notices", "description": "Returns UK public tenders, contract awards and pipeline notices from the official Find a Tender and Contracts Finder APIs, one row per notice with buyer, value in GBP, deadline, CPV codes, source and link. Filter by keyword, CPV code, stage, value and date. onlyNew for daily alerts.", "version": "0.1", "x-build-id": "OuKbUuDUlgaUKCBxj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nightwave-owner~uk-find-a-tender/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nightwave-owner-uk-find-a-tender", "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/nightwave-owner~uk-find-a-tender/runs": { "post": { "operationId": "runs-sync-nightwave-owner-uk-find-a-tender", "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/nightwave-owner~uk-find-a-tender/run-sync": { "post": { "operationId": "run-sync-nightwave-owner-uk-find-a-tender", "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 services to read, for example [\"contracts-finder\"]. find-a-tender: notices under the Procurement Act 2023 and older regulations, mostly larger contracts. contracts-finder: smaller contracts from 12 000 GBP (central government) and 30 000 GBP (other buyers), mostly in England. Defaults to both, mixed newest first.", "items": { "type": "string", "enum": [ "find-a-tender", "contracts-finder" ], "enumTitles": [ "Find a Tender", "Contracts Finder" ] }, "default": [ "find-a-tender", "contracts-finder" ] }, "keywords": { "title": "Keywords", "type": "string", "description": "Optional. Words that must all appear in the title, description or buyer name, in any order and any case, for example \"cloud hosting\" or \"NHS cleaning\". Leave empty for all notices." }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Optional. Only notices with at least one of these CPV codes, for example [\"72000000\"]. Trailing zeros match the whole category: 72000000 (IT services) also matches 72222300. The check digit is optional (72000000-5 works).", "items": { "type": "string" } }, "stages": { "title": "Stages", "type": "array", "description": "tender: open opportunities and their updates and cancellations (UK4 tender notices and older contract notices). planning: pipeline, preliminary market engagement and planned procurement notices. award: contract awards, contract details, modifications and terminations. For example [\"tender\"]. Defaults to tender.", "items": { "type": "string", "enum": [ "tender", "planning", "award" ], "enumTitles": [ "Open tenders", "Planned procurements", "Awards and contracts" ] }, "default": [ "tender" ] }, "publishedFrom": { "title": "Published from", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "First publication date, YYYY-MM-DD (UK time), for example \"2026-10-01\". Defaults to six days before the end date, so the default run covers the last seven days. Earliest 2021-01-01." }, "publishedTo": { "title": "Published to", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Last publication date (inclusive), YYYY-MM-DD (UK time), for example \"2026-10-03\". Defaults to today. At most 31 days per run." }, "valueMin": { "title": "Minimum value (GBP)", "minimum": 0, "type": "integer", "description": "Optional. Only notices whose estimated value (or awarded value, for awards) is at least this many pounds excluding VAT, for example 100000. Notices without a stated value are left out when this is set." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of notices to return, newest first, for example 50. Each notice is one billable result. Defaults to 50.", "default": 50 }, "onlyNew": { "title": "Only new notices", "type": "boolean", "description": "For scheduled runs. When true, notices that an earlier run with the same input already delivered are skipped and not charged, so a daily run returns only notices published since the last run. The first run returns everything. Defaults to false.", "default": false } } }, "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 } } } } } } } } } }