{ "openapi": "3.0.1", "info": { "title": "UK Public Tenders: Find a Tender & Contracts Finder Procurement", "description": "Scrape UK public tenders, government contracts and procurement notices from Find a Tender (FTS) and Contracts Finder in one run. Search by keyword, CPV code, region, value or deadline, with buyers, awards, suppliers and document links. JSON, CSV or Excel. No API key, no login.", "version": "0.1", "x-build-id": "8O3j43k3JbnMukg1g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexus-scrapers~uk-public-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexus-scrapers-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/nexus-scrapers~uk-public-tenders/runs": { "post": { "operationId": "runs-sync-nexus-scrapers-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/nexus-scrapers~uk-public-tenders/run-sync": { "post": { "operationId": "run-sync-nexus-scrapers-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 UK sources to read. Both are used by default; the same notice published on both is returned once.", "items": { "type": "string", "enum": [ "find-a-tender", "contracts-finder" ], "enumTitles": [ "Find a Tender (above-threshold and Procurement Act 2023 notices, whole UK)", "Contracts Finder (below-threshold and central-government notices, England)" ] }, "default": [ "find-a-tender", "contracts-finder" ] }, "keyword": { "title": "Keyword", "type": "string", "description": "Word or phrase that must appear in the title, description or buyer name (case-insensitive). Separate alternatives with a comma: 'solar, photovoltaic' matches either. Leave empty to search everything." }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Common Procurement Vocabulary codes with prefix matching: '72' or '72000000' matches every IT-services code, '7221' matches 7221xxxx. A notice matches if any of its CPV codes matches.", "items": { "type": "string" } }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Which kinds of notices to return. Leave empty for all types. Use 'Tender / contract notices' for opportunities you can bid on and 'Awards' to see who won.", "items": { "type": "string", "enum": [ "contract-notice", "prior-information", "contract-award", "contract-modification", "voluntary-ex-ante", "other" ], "enumTitles": [ "Tender / contract notices (open calls for tender)", "Planning: pipeline, planned procurement, market engagement", "Awards: contract award, contract details, transparency notices (winners, values)", "Contract change notices", "Voluntary ex-ante notices (not used in the UK, kept for schema parity)", "Other (terminations, performance, dynamic market notices)" ] }, "default": [ "contract-notice" ] }, "daysBack": { "title": "Published in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only notices published in the last N days. Ignored if 'Published from' or 'Published to' is set. Use 0 for no date limit (results are always newest first).", "default": 7 }, "dateFrom": { "title": "Published from", "type": "string", "description": "Earliest publication date, format YYYY-MM-DD. Overrides 'last N days'." }, "dateTo": { "title": "Published to", "type": "string", "description": "Latest publication date (inclusive), format YYYY-MM-DD." }, "minValue": { "title": "Minimum value (GBP)", "minimum": 0, "type": "number", "description": "Minimum estimated value (awarded value for award notices), in the notice currency (GBP). Notices without a published value are excluded when a value filter is set." }, "maxValue": { "title": "Maximum value (GBP)", "minimum": 0, "type": "number", "description": "Maximum estimated value (awarded value for award notices), in the notice currency (GBP)." }, "regions": { "title": "Regions", "type": "array", "description": "Only notices whose place of delivery is in one of these regions (English regions, Wales, Scotland, Northern Ireland). Notices that do not state a region are excluded when this filter is set. 'England (nationwide)' and 'UK-wide' match notices that cover the whole country.", "items": { "type": "string", "enum": [ "North East", "North West", "Yorkshire and the Humber", "East Midlands", "West Midlands", "East of England", "London", "South East", "South West", "Wales", "Scotland", "Northern Ireland", "England (nationwide)", "UK-wide" ] } }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of notices to return, newest first. You are charged per result, so keep this low while testing.", "default": 20 }, "cpvLabelLanguage": { "title": "CPV label language", "enum": [ "en", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "ga", "hr", "hu", "it", "lt", "lv", "mt", "nl", "pl", "pt", "ro", "sk", "sl", "sv" ], "type": "string", "description": "Language of the official CPV (Common Procurement Vocabulary) labels in cpvCodes[].label. All 24 EU languages are available; falls back to English.", "default": "en" } } }, "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 } } } } } } } } } }