{ "openapi": "3.0.1", "info": { "title": "UK Unified Tender Feed — Find a Tender + Contracts Finder", "description": "One deduplicated feed of UK public procurement notices across multiple official portals, in a single consistent schema. Organisation-level data only, no personal data.", "version": "1.0", "x-build-id": "k3FNq4wj54IjRFlbN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/civicrows~uk-unified-tender-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-civicrows-uk-unified-tender-feed", "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/civicrows~uk-unified-tender-feed/runs": { "post": { "operationId": "runs-sync-civicrows-uk-unified-tender-feed", "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/civicrows~uk-unified-tender-feed/run-sync": { "post": { "operationId": "run-sync-civicrows-uk-unified-tender-feed", "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 to include", "type": "array", "description": "Which official portals to pull from. More sources means more duplicates removed. Public Contracts Scotland covers the devolved Scottish regime, which is outside the Procurement Act 2023 and is not published on Find a Tender.", "items": { "type": "string", "enum": [ "find-a-tender", "contracts-finder", "public-contracts-scotland" ] }, "default": [ "find-a-tender", "contracts-finder", "public-contracts-scotland" ] }, "dateFrom": { "title": "From date", "type": "string", "description": "Start of the window (ISO 8601). Defaults to 7 days ago. Applied as last-updated on Find a Tender and as publication date on Contracts Finder — the closest equivalent each API offers." }, "dateTo": { "title": "To date", "type": "string", "description": "End of the window (ISO 8601). Defaults to now." }, "stages": { "title": "Procurement stages", "type": "array", "description": "Which stages to return. Leave empty for all. Note: 'implementation' exists only on Contracts Finder and is dropped automatically for Find a Tender, so selecting it will not cause an error.", "items": { "type": "string", "enum": [ "planning", "tender", "award", "implementation" ] }, "default": [] }, "cpvDivisions": { "title": "CPV divisions", "type": "array", "description": "Two-digit CPV divisions to keep, e.g. 45, 85. Empty = all.", "default": [], "items": { "type": "string" } }, "minValue": { "title": "Minimum contract value (GBP)", "minimum": 0, "type": "integer", "description": "Notices with no stated value are always kept." }, "includeDuplicates": { "title": "Keep duplicate rows", "type": "boolean", "description": "Off by default. Turn on only if you want to see every portal's copy of the same procurement separately.", "default": false }, "maxItems": { "title": "Maximum notices", "minimum": 1, "maximum": 50000, "type": "integer", "description": "HARD CAP on results. Default 250 keeps a first run inside the $5/month credit that Apify free-plan users get, so the Actor can be trialled at no cost. Raise it for production pulls. Also protects run time and unit economics.", "default": 250 }, "maxRequestsPerSource": { "title": "Maximum API requests per source", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Second safety cap, applied per source and on pagination rather than results. Protects both your unit economics and the source APIs from an unbounded run.", "default": 150 }, "maxRunSeconds": { "title": "Maximum run time (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Wall-clock budget. The run stops cleanly and returns what it has collected rather than exceeding this. Default 240s, chosen to stay inside Apify's 5-minute quality-check window even if a source imposes a long rate-limit wait.", "default": 240 } } }, "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 } } } } } } } } } }