{ "openapi": "3.0.1", "info": { "title": "EU Tenders Scraper (TED): Public Procurement & Contract Awards", "description": "Search EU public tenders on TED via the official API: open calls, contract awards and planned tenders by keyword, country, CPV code, deadline and value. Buyer, values, deadlines, links. Tender alerts. $1 per 1,000 notices.", "version": "1.0", "x-build-id": "DnIBrknjrVv3ZslCf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/manageable_gully~ted-eu-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-manageable_gully-ted-eu-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/manageable_gully~ted-eu-tenders-scraper/runs": { "post": { "operationId": "runs-sync-manageable_gully-ted-eu-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/manageable_gully~ted-eu-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-manageable_gully-ted-eu-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 (full-text search)", "type": "array", "description": "Words or phrases searched in the full notice text (any EU language, e.g. 'cloud', 'cybersecurity', 'Reinigung'). One per line. Empty = no keyword filter.", "items": { "type": "string" } }, "keywordMatch": { "title": "Keyword match", "enum": [ "any", "all" ], "type": "string", "description": "Match notices containing any of the keywords, or all of them.", "default": "any" }, "countries": { "title": "Countries", "type": "array", "description": "Buyer countries as ISO codes (DE, FR, PL or DEU, FRA) or English names. Covers EU/EEA plus other countries publishing on TED. Empty = all countries.", "items": { "type": "string" } }, "countryField": { "title": "Country means", "enum": [ "buyer", "performance" ], "type": "string", "description": "Filter by the buyer's country (default) or by where the contract is performed.", "default": "buyer" }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Common Procurement Vocabulary codes. 8 digits (72000000 = IT services, includes all sub-codes) or a 2-7 digit prefix (e.g. 45 = construction work). Empty = all sectors.", "items": { "type": "string" } }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Which kinds of TED notices to return. Default: contract notices you can still bid on.", "items": { "type": "string", "enum": [ "competition", "result", "planning", "change", "dir-awa-pre", "cont-modif" ], "enumTitles": [ "Contract notices (open tenders / calls for competition)", "Contract award notices (results, awarded value, winner country)", "Prior information notices (planned tenders)", "Changes & corrigenda", "Direct award pre-announcements", "Contract modifications" ] }, "default": [ "competition" ] }, "onlyOpen": { "title": "Only tenders still open for bids", "type": "boolean", "description": "Keep only notices whose tender submission deadline is today or later.", "default": false }, "publishedFrom": { "title": "Published from", "type": "string", "description": "Publication date on/after: 2026-10-01, 20261001, or relative like '7 days', '2 weeks', '3 months'. Default: last 7 days." }, "publishedTo": { "title": "Published to", "type": "string", "description": "Publication date on/before (same formats). Empty = up to today." }, "deadlineFrom": { "title": "Deadline from", "type": "string", "description": "Tender deadline on/after: a date or '+3 days' (from now)." }, "deadlineTo": { "title": "Deadline to", "type": "string", "description": "Tender deadline on/before: a date or '+30 days' (from now)." }, "minValue": { "title": "Minimum value", "minimum": 0, "type": "integer", "description": "Only notices whose total/estimated value (in the notice currency) is at least this amount. Notices without a value are excluded when set." }, "maxValue": { "title": "Maximum value", "minimum": 0, "type": "integer", "description": "Only notices whose total value is at most this amount." }, "contractNature": { "title": "Contract type", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "services", "supplies", "works", "combined" ], "enumTitles": [ "Services", "Supplies", "Works (construction)", "Combined" ] } }, "procedureTypes": { "title": "Procedure types", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "open", "restricted", "neg-w-call", "neg-wo-call", "comp-dial", "innovation", "oth-single", "oth-mult" ], "enumTitles": [ "Open", "Restricted", "Negotiated with call", "Negotiated without call", "Competitive dialogue", "Innovation partnership", "Other single stage", "Other multi stage" ] } }, "expertQuery": { "title": "TED expert query (advanced)", "type": "string", "description": "Optional extra condition in TED expert-search syntax, ANDed with the filters above, e.g. buyer-city=Wien or classification-cpv IN (79341000 79342000). Do not add SORT BY." }, "language": { "title": "Preferred text language", "enum": [ "ENG", "DEU", "FRA", "SPA", "ITA", "POL", "NLD", "POR", "SWE", "DAN", "FIN", "CES", "SLK", "HUN", "RON", "BUL", "ELL", "HRV", "SLV", "EST", "LAV", "LIT", "MLT", "GLE" ], "type": "string", "description": "Language for the notice title/buyer name when TED has it (notice titles exist in all 24 EU languages; original titles fall back to the notice's own language).", "default": "ENG" }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Add the procurement description text.", "default": true }, "maxDescriptionChars": { "title": "Max description length", "minimum": 100, "type": "integer", "description": "Longer descriptions are cut.", "default": 3000 }, "sort": { "title": "Order", "enum": [ "newest", "oldest" ], "type": "string", "description": "Order by publication number.", "default": "newest" }, "maxItems": { "title": "Max notices", "minimum": 1, "type": "integer", "description": "Stop after this many notices (also limits cost).", "default": 1000 }, "onlyNew": { "title": "Only new notices (alerts)", "type": "boolean", "description": "Remember delivered notices (named key-value store) and return only ones not seen in earlier runs with the same State key. Schedule daily for a tender alert feed. Already-seen notices are free.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Use different keys for different saved searches.", "default": "default" } } }, "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 } } } } } } } } } }