{ "openapi": "3.0.1", "info": { "title": "UK Tenders Scraper: Find a Tender Public Procurement API", "description": "Returns UK public tenders from Find a Tender, the official UK procurement service: open calls for tender, contract awards, pipeline notices, CPV codes, deadlines, values and buyers. Filter by keyword, CPV, region, value and date. No API key.", "version": "0.1", "x-build-id": "A168R1RWdihWbeI39" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/boubap~uk-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-boubap-uk-tenders-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/boubap~uk-tenders-scraper/runs": { "post": { "operationId": "runs-sync-boubap-uk-tenders-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/boubap~uk-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-boubap-uk-tenders-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", "properties": { "keywords": { "title": "Keywords", "type": "string", "description": "Words to find in the notice title or description. Notices must contain all the words, in any order and any case. Example: cloud migration. Leave empty to filter only by CPV code, region, value or date." }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Common Procurement Vocabulary codes or prefixes, one per line. Examples: 72 (IT services), 45 (construction work), 85 (health and social work). The form 72000000-5 also works. Several values combine with OR.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "UK regions where the contract is performed, one per line: names such as London, Scotland, Wales, North West, ITL codes such as UKI, UKM, UKD3, or UK for the whole country. Notices for the whole UK are always kept. Leave empty for all regions.", "items": { "type": "string" } }, "noticeTypes": { "title": "Notice types", "enum": [ "contract-notices", "awards", "planning", "all" ], "type": "string", "description": "Which kind of notices to return: calls for tender (default), contract awards, pipeline and market engagement notices, or all notice types including cancellations.", "default": "contract-notices" }, "publishedWithinDays": { "title": "Published within (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only notices published in the last N days. Minimum 1, maximum 90, default 7. Ignored when Published from is set.", "default": 7 }, "publishedFrom": { "title": "Published from", "type": "string", "description": "Optional start date (YYYY-MM-DD). Replaces Published within (days). A run covers at most 90 days." }, "publishedTo": { "title": "Published to", "type": "string", "description": "Optional end date (YYYY-MM-DD), included. Leave empty for up to today." }, "minValue": { "title": "Minimum value (GBP)", "minimum": 0, "type": "integer", "description": "Keep notices whose estimated value in GBP is at least this amount, excluding VAT. Notices without a published value, or valued in another currency, are dropped when a value limit is set." }, "maxValue": { "title": "Maximum value (GBP)", "minimum": 0, "type": "integer", "description": "Keep notices whose estimated value in GBP is at most this amount, excluding VAT." }, "openOnly": { "title": "Open for bids only", "type": "boolean", "description": "Calls for tender only: keep notices whose submission deadline is today or later. Default: enabled. Disable it to include notices whose deadline has passed.", "default": true }, "maxResults": { "title": "Max notices", "minimum": 1, "type": "integer", "description": "Upper limit of notices returned. Minimum 1, default 1000. The run stops as soon as it is reached.", "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 } } } } } } } } } }