{ "openapi": "3.0.1", "info": { "title": "Find a Tender API: UK Tenders Feed (Unofficial)", "description": "Pull UK public procurement notices from Find a Tender (FTS) as structured data: tenders, contract awards, buyers, CPV codes, values and deadlines. Official OCDS feed, no API key. Filter by date, CPV, region and value, and track new or changed notices. Not affiliated with the Cabinet Office.", "version": "0.1", "x-build-id": "l8NeuZ3NbxljMVdVW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/graylabs~uk-find-a-tender/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-graylabs-uk-find-a-tender", "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/graylabs~uk-find-a-tender/runs": { "post": { "operationId": "runs-sync-graylabs-uk-find-a-tender", "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/graylabs~uk-find-a-tender/run-sync": { "post": { "operationId": "run-sync-graylabs-uk-find-a-tender", "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": { "lastNDays": { "title": "Last N days", "minimum": 1, "maximum": 90, "type": "integer", "description": "Notices published or last updated in the last N days (UTC), including today. Default 3. Ignored if you set a from or to date. Maximum 90." }, "publishedFrom": { "title": "Published from (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Start of the window (UTC, inclusive). Find a Tender filters on the date a notice was published or last updated." }, "publishedTo": { "title": "Published to (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "End of the window (UTC, inclusive). Defaults to today." }, "keywords": { "title": "Keywords", "type": "array", "description": "Match any of these words or phrases in the notice title or description (case-insensitive).", "default": [], "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "8-digit CPV codes, e.g. 72000000 (IT services). Broader codes include their sub-codes (72000000 matches 72220000).", "default": [], "items": { "type": "string" } }, "regions": { "title": "Regions (ITL/NUTS codes)", "type": "array", "description": "E.g. UKI (London), UKF2, UKM (Scotland). Matches delivery regions or the buyer's region by prefix, so UKI includes UKI34.", "default": [], "items": { "type": "string" } }, "noticeKinds": { "title": "Notice kinds", "type": "array", "description": "Planning (market engagement, pipeline), tender (open opportunities), award (contract awards and contract details) or other. Empty = all.", "items": { "type": "string", "enum": [ "planning", "tender", "award", "other" ], "enumTitles": [ "Planning", "Tender (open opportunity)", "Award (result)", "Other" ] }, "default": [] }, "minValue": { "title": "Minimum estimated value", "minimum": 0, "type": "integer", "description": "In the notice's own currency (no conversion). Uses the estimated value (excl. VAT, else incl. VAT), else the awarded value. Notices with no value are excluded when a value filter is set." }, "maxValue": { "title": "Maximum estimated value", "minimum": 0, "type": "integer", "description": "In the notice's own currency (no conversion)." }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after saving this many notices (each saved notice is one charged result).", "default": 100 }, "maxRequests": { "title": "Max API requests", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Safety cap on Find a Tender API calls per run (up to 100 notices each). Default 60.", "default": 60 }, "includeSuppliers": { "title": "Include supplier / winner organisations", "type": "boolean", "description": "Off by default. When on, award notices list winning organisations only. Names that may belong to individuals are withheld and counted.", "default": false }, "includeDescriptions": { "title": "Include descriptions", "type": "boolean", "description": "Off by default. Adds the notice's free-text description (up to 10,000 characters), in the original language.", "default": false }, "trackChanges": { "title": "Track changes between runs", "type": "boolean", "description": "Mark each notice new, updated or unchanged compared with earlier runs of the same search.", "default": false }, "onlyNewOrUpdated": { "title": "Only new or updated notices", "type": "boolean", "description": "With change tracking, skip notices already seen unchanged (they are not charged).", "default": 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 } } } } } } } } } }