{
"openapi": "3.0.1",
"info": {
"title": "EU Tenders Scraper (TED) & UK Find a Tender Bid Alerts",
"description": "Export EU public tenders and contract awards from TED (Tenders Electronic Daily), plus optional UK Find a Tender notices. Filter by keyword, CPV code, country, NUTS region, deadline and value. Daily new-tender alerts. Official APIs, no key needed. CSV, Excel, JSON.",
"version": "1.0",
"x-build-id": "cNUTC5WMBGmwhdfKO"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/studded_columbine~eu-ted-uk-tenders-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-studded_columbine-eu-ted-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/studded_columbine~eu-ted-uk-tenders-scraper/runs": {
"post": {
"operationId": "runs-sync-studded_columbine-eu-ted-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/studded_columbine~eu-ted-uk-tenders-scraper/run-sync": {
"post": {
"operationId": "run-sync-studded_columbine-eu-ted-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": "TED: all EU/EEA public procurement notices above EU thresholds (official TED Search API). UK Find a Tender: UK public procurement notices (official OCDS API; slower, about 100 notices per 11 seconds because of its rate limit).",
"items": {
"type": "string",
"enum": [
"ted",
"uk-fts"
],
"enumTitles": [
"EU – TED (Tenders Electronic Daily)",
"UK – Find a Tender"
]
},
"default": [
"ted"
]
},
"noticeTypes": {
"title": "Notice types",
"type": "array",
"description": "Default: open tenders (contract notices) only. Add 'Contract awards' for award winners and values.",
"items": {
"type": "string",
"enum": [
"competition",
"planning",
"result",
"dir-awa-pre",
"cont-modif",
"change",
"consultation"
],
"enumTitles": [
"Open tenders / contract notices",
"Prior information / planning",
"Contract awards (results)",
"Direct award pre-announcements",
"Contract modifications",
"Corrections / changes",
"Market consultations"
]
},
"default": [
"competition"
]
},
"keywords": {
"title": "Keywords",
"type": "array",
"description": "Any of these words or phrases (OR). TED searches the full notice text in all EU languages (titles are machine-translated, so English keywords work for most notices). UK: matched in title, description and buyer name.",
"items": {
"type": "string"
}
},
"cpvCodes": {
"title": "CPV codes (industry)",
"type": "array",
"description": "CPV codes or prefixes; sub-codes are included. \"72\" = all IT services, \"48\" = software packages, \"45\" = construction work, \"79\" = business services, \"33\" = medical equipment.",
"items": {
"type": "string"
}
},
"countries": {
"title": "Buyer countries",
"type": "array",
"description": "ISO country codes of the buying organisation, 2 or 3 letters (\"DE\", \"FR\", \"PL\", \"NL\", \"IE\"). Leave empty for all. Include \"GB\" if you also use UK Find a Tender.",
"items": {
"type": "string"
}
},
"placeOfPerformance": {
"title": "Place of performance (NUTS)",
"type": "array",
"description": "NUTS region codes, sub-regions included: \"FR1\" = Île-de-France, \"DE21\" = Oberbayern, \"IE06\", \"UKI\" = London.",
"items": {
"type": "string"
}
},
"publishedWithinDays": {
"title": "Published in the last N days",
"minimum": 1,
"maximum": 3650,
"type": "integer",
"description": "1 = today only. Overrides 'Published from'. Default when no dates are set: last 7 days."
},
"publishedFrom": {
"title": "Published from",
"type": "string",
"description": "YYYY-MM-DD"
},
"publishedTo": {
"title": "Published to",
"type": "string",
"description": "YYYY-MM-DD"
},
"onlyOpen": {
"title": "Only tenders still open",
"type": "boolean",
"description": "Only notices whose tender (or request-to-participate) deadline is today or later. Notices without a deadline are excluded.",
"default": false
},
"minValue": {
"title": "Minimum value",
"minimum": 0,
"type": "integer",
"description": "Total / estimated value in the notice's own currency (mostly EUR). Notices without a value are excluded when set."
},
"maxValue": {
"title": "Maximum value",
"minimum": 0,
"type": "integer",
"description": "Same currency caveat as minimum value."
},
"buyerNameIncludes": {
"title": "Buyer name contains",
"type": "string",
"description": "e.g. \"Bundesagentur\", \"NHS\", \"University\"."
},
"expertQuery": {
"title": "TED expert query (advanced)",
"type": "string",
"description": "Optional raw TED expert-search query, ANDed with the filters above (TED only). Example: procedure-type IN (open) AND contract-nature-main-proc IN (services). See the TED expert search help."
},
"language": {
"title": "Title language",
"enum": [
"eng",
"deu",
"fra",
"spa",
"ita",
"nld",
"pol",
"por",
"swe",
"dan",
"fin",
"ces",
"ron",
"hun",
"ell",
"bul",
"slk",
"slv",
"hrv",
"est",
"lav",
"lit",
"mlt",
"gle"
],
"type": "string",
"description": "Language for the translated TED title and buyer name (falls back to English, then the original).",
"default": "eng"
},
"sortBy": {
"title": "Sort",
"enum": [
"newest",
"oldest"
],
"type": "string",
"description": "Newest notices first (best with a max results limit) or oldest first. UK Find a Tender is always newest first.",
"default": "newest"
},
"maxResults": {
"title": "Max notices per source",
"minimum": 0,
"type": "integer",
"description": "Maximum notices to return from each source. 0 = no limit.",
"default": 100
},
"onlyNew": {
"title": "Only notices not returned before",
"type": "boolean",
"description": "Remembers which notices this saved search already returned (per 'State key') and returns only new ones. Schedule it daily for bid alerts.",
"default": false
},
"firstRunBehavior": {
"title": "First run (with 'only new')",
"enum": [
"returnAll",
"baselineOnly"
],
"type": "string",
"description": "'Return all' delivers current matches on the first run; 'Baseline only' silently records them (no charge per notice) so later runs return only notices published after today.",
"default": "returnAll"
},
"stateKey": {
"title": "State key",
"type": "string",
"description": "Name for this alert's memory. Defaults to a hash of the filters. Use different keys for different alerts."
},
"ukMaxPages": {
"title": "UK max pages",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Find a Tender filters only by date on its side, so this Actor scans pages of 100 notices (about 475 per day) at about 11 s per page. Stops after this many pages.",
"default": 60
}
}
},
"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
}
}
}
}
}
}
}
}
}
}