{ "openapi": "3.0.1", "info": { "title": "Public Tenders Scraper - UK & EU Tenders and Contract Awards", "description": "Search public tenders and contract awards from UK Find a Tender, UK Contracts Finder and EU TED in one feed: keywords, CPV codes, countries, dates. Official open data, no login.", "version": "0.1", "x-build-id": "LdCRxLL90V23ZE0tM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapefy~public-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapefy-public-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/scrapefy~public-tenders-scraper/runs": { "post": { "operationId": "runs-sync-scrapefy-public-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/scrapefy~public-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-scrapefy-public-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": "Which official sources to search: ted (EU Tenders Electronic Daily, all EU countries), findATender (UK above-threshold notices) and contractsFinder (UK notices, lower values too). Leave all three for one combined feed.", "items": { "type": "string", "enum": [ "ted", "findATender", "contractsFinder" ], "enumTitles": [ "EU TED (all EU countries)", "UK Find a Tender", "UK Contracts Finder" ] }, "default": [ "ted", "findATender", "contractsFinder" ] }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional words or phrases, for example 'cloud hosting' or 'road maintenance'. A notice matches if it contains any of them. TED searches the full notice text; for the UK sources the title, description and buyer name are checked. Leave empty to get everything in the date range.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Optional Common Procurement Vocabulary codes, for example 72000000 (IT services) or 45000000 (construction). A code ending in zeros also matches everything below it. Combined with keywords, a notice must match both.", "items": { "type": "string" } }, "countries": { "title": "Buyer countries (TED)", "type": "array", "description": "Optional 3-letter ISO country codes of the buying authority, for example DEU, FRA, ITA, POL. Applies to TED. UK sources are included only if GBR is listed or this is empty.", "items": { "type": "string" } }, "noticeStage": { "title": "Notice stage", "enum": [ "all", "tenders", "awards" ], "type": "string", "description": "Tenders returns notices that invite bids, awards returns notices that name the winning suppliers and the contract value, and everything returns both plus other notice types.", "default": "all" }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 365, "type": "integer", "description": "Publication window in days counted back from today. Ignored when 'Published from' is set.", "default": 7 }, "publishedFrom": { "title": "Published from", "type": "string", "description": "Optional first publication date, format YYYY-MM-DD, for example 2026-10-01. Overrides 'Days back'." }, "publishedTo": { "title": "Published to", "type": "string", "description": "Optional last publication date, format YYYY-MM-DD. Default is today." }, "maxItems": { "title": "Max notices per source", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of notices returned from each source. You are charged per notice returned, so this keeps the cost of a run predictable.", "default": 100 }, "maxScanPages": { "title": "Max pages scanned (UK keyword/CPV search)", "minimum": 1, "maximum": 100, "type": "integer", "description": "The UK sources cannot filter by words on their side, so the actor reads pages of 100 notices and filters them. This caps how many pages are read per UK source when keywords or CPV codes are set (30 pages = 3,000 notices).", "default": 30 }, "includeContacts": { "title": "Include buyer contact details", "type": "boolean", "description": "Adds the contact person name, email and phone that UK buyers publish in their notices. Off by default because these are personal data; only enable it if you have a lawful reason to process them.", "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 } } } } } } } } } }