{ "openapi": "3.0.1", "info": { "title": "Uk Find A Tender Scraper", "description": "Extract high-value UK procurement notices from Find a Tender. Filter by dates, keywords, CPV codes, or stages to track tenders, buyers, and contact details. Download your results directly in JSON, CSV, or Excel formats for your sheets or CRM.", "version": "0.0", "x-build-id": "daL5oL8mwyQ6XjZHJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kawsar~uk-find-a-tender-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kawsar-uk-find-a-tender-scraper", "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/kawsar~uk-find-a-tender-scraper/runs": { "post": { "operationId": "runs-sync-kawsar-uk-find-a-tender-scraper", "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/kawsar~uk-find-a-tender-scraper/run-sync": { "post": { "operationId": "run-sync-kawsar-uk-find-a-tender-scraper", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "releases", "filter" ], "type": "string", "description": "releases downloads the public OCDS feed for a date window. filter downloads the same feed and keeps notices that match keyword, CPV prefix, or stage tags on your machine.", "default": "releases" }, "updatedFrom": { "title": "Updated from", "type": "string", "description": "ISO 8601 start of the updatedFrom window sent to the OCDS releases endpoint. Leave empty to omit the parameter.", "default": "2026-10-01T00:00:00" }, "updatedTo": { "title": "Updated to", "type": "string", "description": "ISO 8601 end of the updatedTo window. Leave empty to omit the parameter and let the feed use its own upper bound.", "default": "" }, "stages": { "title": "Stage tags", "type": "array", "description": "Local tag filter such as planning, tender, or award. Applied after download. This value is not sent as a query parameter because that parameter was not verified.", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Used only in filter mode. Case-insensitive match against the tender title and tender text.", "default": "" }, "cpvPrefix": { "title": "CPV prefix", "type": "string", "description": "Used only in filter mode. Keeps notices whose CPV classification id starts with this prefix.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of notice rows to save. Hard cap is 1000.", "default": 100 }, "requestDelaySecs": { "title": "Delay between requests (s)", "minimum": 0, "type": "number", "description": "Seconds to wait between OCDS page requests. Default is 1 second.", "default": 1 }, "userAgent": { "title": "User-Agent", "type": "string", "description": "User-Agent sent on every request. Keep a contact address so the publisher can identify the client.", "default": "" }, "timeoutSecs": { "title": "Run timeout (s)", "minimum": 1, "maximum": 3600, "type": "integer", "description": "Maximum seconds for the whole run. The actor stops fetching when this deadline is reached.", "default": 300 }, "requestTimeoutSecs": { "title": "Request timeout (s)", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximum seconds to wait for a single HTTP response.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. Default is no proxy. Turn on Apify Proxy only if you need another IP.", "default": { "useApifyProxy": 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 } } } } } } } } } }