{ "openapi": "3.0.1", "info": { "title": "Uk Contracts Finder Scraper", "description": "Collect UK public procurement notices, tenders, and awards from Contracts Finder. Filter by keyword, status, or date, and export clean results as JSON, CSV, or Excel for seamless bid tracking and pipeline analysis.", "version": "0.0", "x-build-id": "XUwem9VpHxGPLvQbS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_lead_generation~uk-contracts-finder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_lead_generation-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/b2b_lead_generation~uk-contracts-finder-scraper/runs": { "post": { "operationId": "runs-sync-b2b_lead_generation-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/b2b_lead_generation~uk-contracts-finder-scraper/run-sync": { "post": { "operationId": "run-sync-b2b_lead_generation-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "ocds" ], "type": "string", "description": "Notice search posts the public search API. OCDS by date reads the published Open Contracting feed and follows its next link.", "default": "search" }, "keyword": { "title": "Keyword", "type": "string", "description": "Text matched against notice search. Used in search mode. Example: software.", "default": "software" }, "statuses": { "title": "Statuses", "type": "array", "description": "Notice statuses for search mode. Typical values: Open, Closed, Awarded, Withdrawn.", "default": [ "Open" ], "items": { "type": "string" } }, "types": { "title": "Notice types", "type": "array", "description": "Notice types for search mode. Typical values: Contract, Opportunity, EarlyEngagement, FutureOpportunity.", "default": [ "Contract" ], "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Region names for search mode, using Contracts Finder region names. Leave empty to skip the region filter.", "default": [], "items": { "type": "string" } }, "valueFrom": { "title": "Minimum value (GBP)", "type": "integer", "description": "Lowest contract value in pounds included in search mode. Leave empty to set no minimum." }, "valueTo": { "title": "Maximum value (GBP)", "type": "integer", "description": "Highest contract value in pounds included in search mode. Leave empty to set no maximum." }, "publishedFrom": { "title": "Published from", "type": "string", "description": "Inclusive start of the published window, as an ISO date or date-time. Used by search and OCDS modes. Leave empty to omit.", "default": "" }, "publishedTo": { "title": "Published to", "type": "string", "description": "Inclusive end of the published window, as an ISO date or date-time. Used by search and OCDS modes. Leave empty to omit.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum notice rows to save this run. Hard cap is 1000.", "default": 100 }, "requestDelaySecs": { "title": "Delay between requests (seconds)", "minimum": 0, "maximum": 60, "type": "integer", "description": "Pause between HTTP calls. The actor never goes faster than 1 request per second, even if this is 0.", "default": 1 }, "timeoutSecs": { "title": "Run timeout (seconds)", "minimum": 1, "maximum": 3600, "type": "integer", "description": "Stop the run after this many seconds. Default is 300. Maximum is 3600.", "default": 300 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 1, "maximum": 120, "type": "integer", "description": "How long to wait for one HTTP response before giving up. Default is 30 seconds.", "default": 30 }, "userAgent": { "title": "User-Agent", "type": "string", "description": "User-Agent sent on every request. Keep a contact address so the source can identify the client.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy for requests. Default is no proxy. Turn on Apify Proxy only if you need another IP.", "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 }, "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 } } } } } } } } } }