{ "openapi": "3.0.1", "info": { "title": "UK Tender Monitor", "description": "Find UK public sector tenders on Contracts Finder by keyword, region, value or CPV code. Returns buyer, value, deadline and days left to bid, SME suitability, and the winning supplier and price once awarded. Flags new tenders and fresh awards.", "version": "0.1", "x-build-id": "FlS7mu87aF1DFekrY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arched_friend~uk-tender-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arched_friend-uk-tender-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/arched_friend~uk-tender-monitor/runs": { "post": { "operationId": "runs-sync-arched_friend-uk-tender-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/arched_friend~uk-tender-monitor/run-sync": { "post": { "operationId": "run-sync-arched_friend-uk-tender-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": { "keywords": { "title": "Keywords", "type": "array", "description": "What you sell, one per line, for example cleaning, cyber security or software. Each keyword runs its own search and the results are merged. Leave empty to see everything in the period.", "items": { "type": "string" } }, "statuses": { "title": "Notice status", "type": "array", "description": "Open tenders are taking bids now. Awarded notices show who won and for how much.", "items": { "type": "string", "enum": [ "Open", "Closed", "Awarded", "Withdrawn" ], "enumTitles": [ "Open (bid now)", "Closed", "Awarded (see the winner)", "Withdrawn" ] }, "default": [ "Open" ] }, "lastDays": { "title": "Published or updated in the last N days", "minimum": 1, "maximum": 365, "type": "integer", "description": "How far back to search. Keep it short for a scheduled run.", "default": 30 }, "regions": { "title": "Regions", "type": "array", "description": "Only notices for these regions. Notices open to any region are always kept. Leave empty for all.", "items": { "type": "string", "enum": [ "North East", "North West", "Yorkshire and The Humber", "East Midlands", "West Midlands", "East of England", "London", "South East", "South West", "Scotland", "Wales", "Northern Ireland" ], "enumTitles": [ "North East", "North West", "Yorkshire and The Humber", "East Midlands", "West Midlands", "East of England", "London", "South East", "South West", "Scotland", "Wales", "Northern Ireland" ] }, "default": [] }, "minValue": { "title": "Minimum value (GBP)", "minimum": 0, "type": "integer", "description": "Drop notices worth less than this. Notices with no published value are kept.", "default": 0 }, "smeOnly": { "title": "Only notices suitable for SMEs", "type": "boolean", "description": "Drop notices the buyer has marked as not suitable for small and medium businesses.", "default": false }, "cpvPrefixes": { "title": "CPV code prefixes", "type": "array", "description": "Optional. Keep notices whose CPV codes start with any of these, one per line, for example 72 for IT services or 90910 for cleaning.", "items": { "type": "string" } }, "buyers": { "title": "Buyers", "type": "array", "description": "Optional. Keep notices from buyers whose name contains any of these, one per line, for example NHS or Council.", "items": { "type": "string" } }, "excludeTerms": { "title": "Exclude wording", "type": "array", "description": "Drop notices whose title, buyer or description contains any of these, one per line.", "items": { "type": "string" } }, "closingWithinDays": { "title": "Closing within N days", "minimum": 0, "maximum": 365, "type": "integer", "description": "Only notices whose bid deadline falls in the next N days. 0 keeps everything.", "default": 0 }, "onlyChanged": { "title": "Only new and changed notices", "type": "boolean", "description": "Return nothing on a quiet run. Turn this on for a scheduled search so you only hear about new tenders, fresh awards and moved deadlines.", "default": false }, "maxResults": { "title": "Maximum notices per keyword", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The most notices to read for each keyword.", "default": 500 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for one answer from Contracts Finder before giving up on it.", "default": 45 }, "timeBudgetSecs": { "title": "Time budget (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "How long the run may spend before it returns what it has.", "default": 150 } } }, "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 } } } } } } } } } }