{ "openapi": "3.0.1", "info": { "title": "UK Contracts Finder Tenders & Awards Scraper", "description": "Extract UK public sector tenders and awarded contracts from Contracts Finder. Get title, buyer and contact, contract value, CPV codes, procurement stage, deadline and the awarded supplier with company number. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "Qpw665ptiGSvFgacL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~uk-contracts-finder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-uk-contracts-finder-scraper", "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/scrapers_lat~uk-contracts-finder-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-uk-contracts-finder-scraper", "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/scrapers_lat~uk-contracts-finder-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-uk-contracts-finder-scraper", "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": { "query": { "title": "Search Keyword", "type": "string", "description": "Keyword to search across notice title, description, buyer and supplier, for example 'cloud hosting', 'school catering' or 'road resurfacing'. Leave empty to return all notices in the selected stage and date range." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of notices to collect across all matching filters. Optional." }, "stages": { "title": "Procurement Stage", "type": "array", "description": "Filter by procurement stage. 'tender' returns live and closed opportunities, 'award' returns awarded contracts with the winning supplier, 'planning' returns early pipeline notices. Leave empty for all stages.", "items": { "type": "string", "enum": [ "tender", "award", "planning" ], "enumTitles": [ "Tender (open and closed opportunities)", "Award (awarded contracts)", "Planning (pipeline notices)" ] } }, "region": { "title": "Region Code", "type": "string", "description": "Filter by UK region using an ONS/NUTS region code, for example 'UKI' for London, 'UKD' for North West England, 'UKM' for Scotland, 'UKL' for Wales. Leave empty for all regions." }, "cpvCodes": { "title": "CPV Codes", "type": "string", "description": "Filter by Common Procurement Vocabulary (CPV) sector codes, comma-separated, for example '72000000, 48000000'. 45000000 is construction work, 72000000 is IT services, 33000000 is medical equipment, 79000000 is business services. Leave empty for all sectors." }, "publishedFrom": { "title": "Published From (YYYY-MM-DD)", "type": "string", "description": "Only include notices published on or after this date, format YYYY-MM-DD, for example '2026-06-01'. Leave empty for no lower bound." }, "publishedTo": { "title": "Published To (YYYY-MM-DD)", "type": "string", "description": "Only include notices published on or before this date, format YYYY-MM-DD, for example '2026-06-30'. Leave empty to use today." }, "valueFrom": { "title": "Minimum Value (GBP)", "minimum": 0, "type": "integer", "description": "Only include notices with a contract value at or above this amount in pounds, for example 100000. Leave empty for no lower bound." }, "valueTo": { "title": "Maximum Value (GBP)", "minimum": 0, "type": "integer", "description": "Only include notices with a contract value at or below this amount in pounds, for example 5000000. Leave empty for no upper bound." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional Apify proxy configuration. The source is globally accessible and normally needs no proxy; enable this only if you hit rate limits.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }