{ "openapi": "3.0.1", "info": { "title": "UK Public Tender Monitor (CF + FTS)", "description": "Unofficial tool, not affiliated with UK Government/Cabinet Office. Get only new and amended UK public notices from Find a Tender and Contracts Finder since your last run, in one feed. OGL v3.0 data.", "version": "0.2", "x-build-id": "sCqA4PEjS19Cal95W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/flamelit_constellation~uk-public-tender-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-flamelit_constellation-uk-public-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/flamelit_constellation~uk-public-tender-monitor/runs": { "post": { "operationId": "runs-sync-flamelit_constellation-uk-public-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/flamelit_constellation~uk-public-tender-monitor/run-sync": { "post": { "operationId": "run-sync-flamelit_constellation-uk-public-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": { "includeDescriptions": { "title": "Include free-text descriptions", "type": "boolean", "description": "Off by default. If on, the notice description is included in extra.description, trimmed at the first contact detail (role label, initials, name pattern) with \"[contact details removed]\". Descriptions are free text written by buyers and may still contain personal names that the trimming misses; leave off unless you need them.", "default": false }, "portals": { "title": "Portals", "type": "array", "description": "Which UK portals to check: \"fts\" (Find a Tender) and/or \"cf\" (Contracts Finder). With both, notices that appear on both portals (same title and buyer) are merged into one Find a Tender record, with the Contracts Finder copy listed under extra.alsoOn.", "default": [ "fts", "cf" ], "items": { "type": "string" } }, "lookbackDays": { "title": "Look back (days)", "type": "integer", "description": "How many days of published/updated notices to check, counting back from now.", "default": 3 }, "keywords": { "title": "Title keywords", "type": "array", "description": "Only include notices whose title contains at least one of these words (case-insensitive). Leave empty for all.", "default": [], "items": { "type": "string" } }, "maxPages": { "title": "Max pages per portal", "type": "integer", "description": "Upper limit on API pages (100 notices each) per portal per run. Pages are at least 6 seconds apart.", "default": 5 }, "maxSpendUsd": { "title": "Max spend (USD)", "type": "number", "description": "Hard spending cap for this run, in US dollars. The actor stops charging and stops adding results once this amount is reached. Unsent items are kept for the next run.", "default": 1 }, "emitUnchanged": { "title": "Include unchanged items", "type": "boolean", "description": "If on, items already seen in earlier runs (changeType \"same\") are also output. Off by default, so you only get new and amended items. Unchanged items are never charged.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Optional name of the key-value store that remembers what earlier runs saw. Use a different name per saved search so each search tracks its own new/amended items. Leave empty to use the run's default store." }, "fixturePath": { "title": "Test fixture path (developers only)", "type": "string", "description": "Testing only. Path to a local file to replay instead of calling the live source. Leave empty for normal use." } } }, "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 } } } } } } } } } }