{ "openapi": "3.0.1", "info": { "title": "UK Government Tenders & Contract Awards Monitor", "description": "Monitor UK public-sector tenders and contract awards from both Contracts Finder and Find a Tender in one feed. Track open opportunities or see which suppliers win. Filter by keyword, CPV code, value and deadline. Buyer, value, region, award and official link per record. No API key needed.", "version": "0.1", "x-build-id": "p3jiLX6WgCQiFKNdM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/devon_gtme~uk-tenders-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-devon_gtme-uk-tenders-monitor", "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/devon_gtme~uk-tenders-monitor/runs": { "post": { "operationId": "runs-sync-devon_gtme-uk-tenders-monitor", "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/devon_gtme~uk-tenders-monitor/run-sync": { "post": { "operationId": "run-sync-devon_gtme-uk-tenders-monitor", "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": { "source": { "title": "Data Source", "enum": [ "both", "contractsFinder", "findATender" ], "type": "string", "description": "Which official register to pull from. Contracts Finder = below-threshold contracts + England; Find a Tender = high-value (above-threshold) contracts UK-wide. \"Both\" merges and dedupes them.", "default": "both" }, "noticeTypes": { "title": "Notice Types", "enum": [ "opportunities", "awards", "both" ], "type": "string", "description": "Opportunities = open tenders you can still bid for (win-work mode). Awards = contracts already awarded, including winning supplier and value (competitive-intel mode).", "default": "opportunities" }, "daysBack": { "title": "Days Back", "minimum": 1, "maximum": 365, "type": "integer", "description": "Fetch notices published/updated in the last N days. Default 7 — schedule the actor weekly for a rolling monitor.", "default": 7 }, "keywords": { "title": "Keywords (OR-matched)", "type": "array", "description": "Keep notices whose title, description, or buyer name contains ANY of these terms (case-insensitive). E.g. [\"software\", \"digital transformation\", \"CRM\"]. Leave empty for all notices.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV Sector Codes", "type": "array", "description": "Filter by CPV (Common Procurement Vocabulary) sector codes — prefix match, so \"72000000\" or just \"72\" matches all IT services. Common examples: 72000000 IT services, 48000000 software packages, 79000000 business/consulting services, 45000000 construction, 90000000 environmental/waste, 85000000 health & social care, 79340000 advertising & marketing, 80000000 education & training, 60000000 transport, 77000000 agriculture & forestry, 71000000 architecture & engineering.", "items": { "type": "string" } }, "minValue": { "title": "Min Value (GBP)", "minimum": 0, "type": "integer", "description": "Keep notices worth at least this much (tender estimate, or awarded value for awards). Notices with no stated value are excluded when set." }, "maxValue": { "title": "Max Value (GBP)", "minimum": 0, "type": "integer", "description": "Keep notices worth at most this much — useful to filter down to SME-sized contracts." }, "deadlineWithinDays": { "title": "Deadline Within Days (0 = off)", "minimum": 0, "maximum": 365, "type": "integer", "description": "\"Closing soon\" filter: only keep open tenders whose submission deadline is within the next N days. 0 disables the filter.", "default": 0 }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum notices to return across both sources.", "default": 200 } } }, "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 } } } } } } } } } }