{ "openapi": "3.0.1", "info": { "title": "EU & UK Tenders Scraper: TED + Find a Tender", "description": "Public procurement tenders from the EU's TED and the UK's Find a Tender official APIs: buyer, CPV, value, deadline, winners and a plain-English summary per notice. Keyword, CPV, country and value filters, daily monitor mode. $3 per 1,000 notices.", "version": "0.1", "x-build-id": "di4yzM0Efnvs2zR1f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/meridianlabs~eu-uk-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-meridianlabs-eu-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/meridianlabs~eu-uk-tenders-scraper/runs": { "post": { "operationId": "runs-sync-meridianlabs-eu-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/meridianlabs~eu-uk-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-meridianlabs-eu-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": "Where to search. ted = TED (Tenders Electronic Daily), the EU's official journal of public procurement: all EU/EEA countries plus EU institutions. uk = Find a Tender, the UK government's official service (Procurement Act 2023 and older notices).", "items": { "type": "string", "enum": [ "ted", "uk" ], "enumTitles": [ "TED (EU, official API)", "Find a Tender (UK, official API)" ] }, "default": [ "ted", "uk" ] }, "keywords": { "title": "Keywords (any of)", "type": "array", "description": "Words or phrases to find in the notice, e.g. software, road resurfacing, cleaning services. A notice matches if it contains ANY of them. TED searches its full text in every language (its index includes translated CPV labels, so English words also find many non-English notices); UK notices are matched on title, description and CPV label. Leave empty for all notices.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes (any of)", "type": "array", "description": "Common Procurement Vocabulary codes, e.g. 72000000 (IT services), 45233000 (road works), 90910000 (cleaning). Broader codes include everything under them: 45000000 matches all construction work. 45233000-9 and short prefixes like 452 are accepted.", "items": { "type": "string" } }, "countries": { "title": "Buyer countries (any of)", "type": "array", "description": "Country of the contracting authority, as ISO codes or names: FR or FRA, DE or DEU, UK or GBR, Ireland … Leave empty for all. A list without the UK skips the UK source (free).", "items": { "type": "string" } }, "buyerName": { "title": "Buyer name contains", "type": "string", "description": "Part of the contracting authority's name, e.g. Lyon, NHS, Bundesamt." }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "contract_notice = open calls for tenders you can still bid on. award = who won and for how much (organisations only). prior_information = planned purchases and market engagement. other = changes, cancellations, completions.", "items": { "type": "string", "enum": [ "contract_notice", "award", "prior_information", "other" ], "enumTitles": [ "Contract notices (open tenders)", "Contract awards", "Prior information / planned", "Other (changes, cancellations)" ] }, "default": [ "contract_notice" ] }, "publishedWithinDays": { "title": "Published in the last N days", "minimum": 1, "maximum": 366, "type": "integer", "description": "Publication window ending today. Ignored when 'Published on or after' is set. TED publishes Monday to Friday.", "default": 7 }, "publishedAfter": { "title": "Published on or after", "type": "string", "description": "YYYY-MM-DD. Replaces 'Published in the last N days'. Windows up to 366 days." }, "publishedBefore": { "title": "Published on or before", "type": "string", "description": "YYYY-MM-DD. Default today." }, "deadlineAfter": { "title": "Bid deadline on or after", "type": "string", "description": "YYYY-MM-DD. Set it to today to get only tenders still open. Notices without a deadline are left out when a deadline filter is set." }, "deadlineBefore": { "title": "Bid deadline on or before", "type": "string", "description": "YYYY-MM-DD." }, "minValue": { "title": "Minimum value", "minimum": 0, "type": "integer", "description": "Estimated value (awarded value for awards), in the notice's own currency. Notices without a value are left out when a value filter is set." }, "maxValue": { "title": "Maximum value", "minimum": 0, "type": "integer", "description": "Same rules as the minimum." }, "valueCurrency": { "title": "Value currency", "type": "string", "description": "Optional 3-letter code (EUR, GBP, PLN, SEK …). When set, only notices valued in this currency pass the value filter, so EUR and SEK amounts are never compared." }, "maxNoticesPerSource": { "title": "Max notices per source", "minimum": 0, "type": "integer", "description": "Newest first. 0 = no limit (a week of every TED notice is about 17,000). You pay only for notices saved.", "default": 100 }, "mode": { "title": "Mode", "enum": [ "all", "newSinceLastRun" ], "type": "string", "description": "Monitor mode remembers which notices it returned (per monitor name and search), so a daily schedule returns, and charges, only new ones. The first run sees every match as new.", "default": "all" }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Separate names keep separate memories, e.g. one per client or alert. Only used in monitor mode.", "default": "default" }, "tedQuery": { "title": "Extra TED expert query (advanced)", "type": "string", "description": "Added with AND to the TED search, in TED's expert-search syntax, e.g. place-of-performance-country-proc IN (IRL). Not applied to UK notices." }, "failOnErrors": { "title": "Fail the run if a source fails", "type": "boolean", "description": "For schedules: the run is marked failed (so Apify can alert you) if TED or Find a Tender couldn't be searched or changed its format. Notices already saved stay saved and charged; failures are never charged.", "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 } } } } } } } } } }