{ "openapi": "3.0.1", "info": { "title": "UK Tenders Scraper", "description": "Find a Tender and Contracts Finder, the UK government's two procurement services, in one table of notices with buyer, deadline, value and CPV codes. Their open data APIs do not filter by CPV code or keyword, so the actor reads the newest notices, filters them itself and can return only new ones.", "version": "0.1", "x-build-id": "cf3qlAr2aLtReo4DV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~uk-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-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/deriverge~uk-tenders-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-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/deriverge~uk-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-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": { "sources": { "title": "Sources", "type": "array", "description": "This actor covers both official UK services (uk-fts,uk-cf). Leave empty to read all of them. Sources outside this actor are skipped and listed in the run summary; the multi-source actor covers those.", "items": { "type": "string" } }, "cpv": { "title": "CPV codes", "type": "array", "description": "Common Procurement Vocabulary codes, the official taxonomy of what is being bought. Use the eight-digit code, for example 72000000 for IT services or 45000000 for construction. A division code matches everything inside it.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Full text search over the notice. Any of the words is enough to keep a notice. Leave empty to rely on the CPV codes instead.", "items": { "type": "string" } }, "publishedFrom": { "title": "Published from (YYYY-MM-DD)", "type": "string", "description": "First publication date to include; on Find a Tender, the date the notice was last updated. With both dates and Deadline on or after left empty, both services are read for the last seven days." }, "publishedTo": { "title": "Published to (YYYY-MM-DD)", "type": "string", "description": "Last publication date to include, inclusive." }, "deadlineAfter": { "title": "Deadline on or after (YYYY-MM-DD)", "type": "string", "description": "Keep only notices whose deadline for receipt of tenders falls on or after this date. This is the filter that separates contracts you can still bid for from the archive. Set without publication dates, it replaces the seven-day default and the services are read from their newest notice back." }, "onlyOpen": { "title": "Only notices you can still bid for", "type": "boolean", "description": "Keeps only notices at the tender, tenderUpdate or tenderAmendment stage whose deadline has not passed; notices without a deadline stay. The services cannot filter, so this runs after reading and a run can return fewer rows than Maximum notices. Notices removed by this filter are never charged.", "default": false }, "minValue": { "title": "Minimum contract value", "type": "integer", "description": "Keep only notices whose published value is at least this much, in the currency the source publishes. Notices with no published value are kept, because an absent value is not a small one." }, "newOnly": { "title": "Return only notices new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only notices that were not there before or whose deadline or status moved. A tender has a short deadline, so a scheduled watch is worth more than a one-off export.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"it-services-germany\". Runs from a saved task get a snapshot automatically even without a name." }, "maxItems": { "title": "Maximum notices", "minimum": 1, "type": "integer", "description": "Hard cap on returned notices across all sources in the run.", "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 } } } } } } } } } }