{ "openapi": "3.0.1", "info": { "title": "UK Government Contracts", "description": "Scrape UK government contract data from Contracts Finder. Perfect for market analysis, monitoring, and public sector procurement.", "version": "0.0", "x-build-id": "mzHUpsupLqNZQKiVa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nocodeventure~uk-government-contracts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nocodeventure-uk-government-contracts", "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/nocodeventure~uk-government-contracts/runs": { "post": { "operationId": "runs-sync-nocodeventure-uk-government-contracts", "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/nocodeventure~uk-government-contracts/run-sync": { "post": { "operationId": "run-sync-nocodeventure-uk-government-contracts", "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": { "keywords": { "title": "Keywords", "type": "string", "description": "Search keywords to find contracts (e.g., 'construction', 'IT services', 'handyman')" }, "locationType": { "title": "Location Type", "enum": [ "all_locations", "region", "postcode" ], "type": "string", "description": "How to filter by location", "default": "all_locations" }, "postcode": { "title": "Postcode", "type": "string", "description": "UK postcode to search near (only used when Location Type is 'By Postcode')" }, "postcodeDistance": { "title": "Postcode Distance", "enum": [ "5", "10", "20", "30", "40", "50" ], "type": "string", "description": "Distance from postcode to search within", "default": "20" }, "regions": { "title": "Regions", "type": "array", "description": "Regions to filter by (only used when Location Type is 'By Region')", "items": { "type": "string", "enum": [ "united_kingdom", "england", "north_east", "north_west", "yorkshire_and_the_humber", "east_midlands", "west_midlands", "east_of_england", "london", "south_east", "south_west", "scotland", "wales", "northern_ireland", "isle_of_man", "channel_islands", "british_overseas_territories", "europe", "rest_of_world" ], "enumTitles": [ "United Kingdom", "England", "North East", "North West", "Yorkshire and the Humber", "East Midlands", "West Midlands", "East of England", "London", "South East", "South West", "Scotland", "Wales", "Northern Ireland", "Isle of Man", "Channel Islands", "British Overseas Territories", "Europe", "Rest of the World" ] }, "default": [] }, "includeEarlyEngagement": { "title": "Early Engagement", "type": "boolean", "description": "Include Early Engagement notices (speculative interest before formal procurement)", "default": true }, "includeFutureOpportunity": { "title": "Future Opportunity", "type": "boolean", "description": "Include Future Opportunity notices (planned procurements)", "default": true }, "includeOpportunity": { "title": "Opportunity", "type": "boolean", "description": "Include Opportunity notices (active tenders)", "default": true }, "includeAwarded": { "title": "Awarded", "type": "boolean", "description": "Include Awarded contract notices", "default": false }, "includeOpenOnly": { "title": "Open Opportunities Only", "type": "boolean", "description": "Only include open opportunities (exclude closed ones)", "default": true }, "suitableForSME": { "title": "Suitable for SME", "type": "boolean", "description": "Filter for contracts suitable for Small and Medium Enterprises", "default": false }, "suitableForVCSE": { "title": "Suitable for VCSE", "type": "boolean", "description": "Filter for contracts suitable for Voluntary, Community and Social Enterprises", "default": false }, "valueFrom": { "title": "Minimum Value (£)", "minimum": 0, "type": "integer", "description": "Minimum contract value in GBP (leave empty for no minimum)" }, "valueTo": { "title": "Maximum Value (£)", "minimum": 0, "type": "integer", "description": "Maximum contract value in GBP (leave empty for no maximum)" }, "cpvCodes": { "title": "CPV Codes", "type": "array", "description": "Common Procurement Vocabulary codes to filter by (e.g., ['03000000', '15000000'])", "default": [], "items": { "type": "string" } }, "publishedFrom": { "title": "Published From", "type": "string", "description": "Filter notices published from this date (DD/MM/YYYY format)" }, "publishedTo": { "title": "Published To", "type": "string", "description": "Filter notices published until this date (DD/MM/YYYY format)" }, "closingFrom": { "title": "Closing From", "type": "string", "description": "Filter notices with closing date from this date (DD/MM/YYYY format)" }, "closingTo": { "title": "Closing To", "type": "string", "description": "Filter notices with closing date until this date (DD/MM/YYYY format)" }, "approachToMarketFrom": { "title": "Approach to Market From", "type": "string", "description": "Filter by approach to market date from (DD/MM/YYYY format) - for future opportunities" }, "approachToMarketTo": { "title": "Approach to Market To", "type": "string", "description": "Filter by approach to market date until (DD/MM/YYYY format) - for future opportunities" }, "awardedFrom": { "title": "Awarded From", "type": "string", "description": "Filter by contract awarded date from (DD/MM/YYYY format)" }, "awardedTo": { "title": "Awarded To", "type": "string", "description": "Filter by contract awarded date until (DD/MM/YYYY format)" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of contracts to scrape (0 = unlimited)", "default": 5 }, "scrapeDetails": { "title": "Scrape Full Details", "type": "boolean", "description": "Navigate to each contract page to scrape full details (slower but more complete)", "default": true }, "maxRequestsPerCrawl": { "title": "Max Requests per Crawl", "minimum": 0, "type": "integer", "description": "Maximum number of requests that can be made by this crawler. Set to 0 for unlimited.", "default": 0 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of parallel browser sessions. Lower values are more polite to the server but slower.", "default": 3 }, "requestDelaySeconds": { "title": "Delay Between Requests (seconds)", "minimum": 0, "maximum": 60, "type": "integer", "description": "Minimum delay in seconds between requests. Higher values reduce server load.", "default": 1 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for avoiding IP blocks.", "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 } } } } } } } } } }