{ "openapi": "3.0.1", "info": { "title": "UK Public Tenders Feed (Contracts Finder + Find a Tender)", "description": "Every new UK public-sector tender in one clean, de-duplicated feed from the official Contracts Finder and Find a Tender APIs. Filter by keyword, CPV, value, region, SME suitability and deadline; 'only new' mode for daily alerts. No scraping, no personal contact data.", "version": "0.1", "x-build-id": "oBcbhSccJMqjowbHg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/owenryland~uk-public-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-owenryland-uk-public-tenders", "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/owenryland~uk-public-tenders/runs": { "post": { "operationId": "runs-sync-owenryland-uk-public-tenders", "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/owenryland~uk-public-tenders/run-sync": { "post": { "operationId": "run-sync-owenryland-uk-public-tenders", "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 (any)", "type": "array", "description": "Keep notices whose title or description contains any of these words or phrases (whole-word, case-insensitive). Leave empty for all.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop notices containing any of these words or phrases.", "items": { "type": "string" } }, "cpvPrefixes": { "title": "CPV code prefixes", "type": "array", "description": "Keep notices whose main or additional CPV code starts with any of these, e.g. 72 (IT services), 90910000 (cleaning), 45 (construction).", "items": { "type": "string" } }, "minValueGbp": { "title": "Minimum value (£)", "minimum": 0, "type": "integer", "description": "Notices without a stated value are dropped when a minimum or maximum is set." }, "maxValueGbp": { "title": "Maximum value (£)", "minimum": 0, "type": "integer", "description": "Only include notices whose estimated value is at or below this amount in pounds. Leave empty for no upper limit." }, "regions": { "title": "Delivery regions (ITL/NUTS codes)", "type": "array", "description": "Prefix match on delivery or buyer region codes, e.g. UKD (North West), UKI (London), UKM (Scotland), UKL (Wales). Many Contracts Finder notices give no region, so they are dropped when this is set.", "items": { "type": "string" } }, "buyerPostcodePrefixes": { "title": "Buyer postcode prefixes", "type": "array", "description": "Keep notices whose buyer's address postcode starts with these, e.g. M, BB11, LS.", "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "Find a Tender (all above-threshold and, since the Procurement Act 2023, many below-threshold notices) and Contracts Finder (England below-threshold).", "items": { "type": "string", "enum": [ "find-a-tender", "contracts-finder" ], "enumTitles": [ "Find a Tender", "Contracts Finder" ] }, "default": [ "find-a-tender", "contracts-finder" ] }, "stages": { "title": "Notice stages", "type": "array", "description": "Which notice types to return: open tenders you can bid on, pipeline/planning notices, or contract awards.", "items": { "type": "string", "enum": [ "tender", "planning", "award" ], "enumTitles": [ "Open tenders", "Pipeline / planning", "Contract awards" ] }, "default": [ "tender" ] }, "publishedWithinDays": { "title": "Published or updated within (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only include notices published or updated in the last N days (1 to 90).", "default": 7 }, "openOnly": { "title": "Only tenders still open", "type": "boolean", "description": "For the tender stage, drop notices whose deadline has passed or that are cancelled.", "default": true }, "smeSuitableOnly": { "title": "Only SME-suitable", "type": "boolean", "description": "Only return notices the buyer has marked as suitable for small and medium-sized enterprises.", "default": false }, "onlyNew": { "title": "Only new since last run", "type": "boolean", "description": "Remembers delivered notices in a named key-value store, so a daily schedule gives you just the fresh ones (and you only pay for those).", "default": false }, "maxResults": { "title": "Max notices", "minimum": 1, "maximum": 5000, "type": "integer", "description": "The maximum number of notices to output in one run (each output notice is one billable event).", "default": 200 }, "descriptionMaxChars": { "title": "Max description length", "minimum": 0, "type": "integer", "description": "0 = full text.", "default": 1000 } } }, "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 } } } } } } } } } }