{ "openapi": "3.0.1", "info": { "title": "EU Public Tenders (TED) – Search & Daily Alerts API", "description": "Search EU public tenders from TED (Tenders Electronic Daily) via the official open TED API. Simple filters for keyword, country, CPV, notice type, value and deadline. Flat JSON with buyer, CPV, value, deadline and TED link. Pay per notice.", "version": "1.0", "x-build-id": "twxO3vwLYkoZNdFoa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fast_data_asap~eu-tenders-ted-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fast_data_asap-eu-tenders-ted-api", "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/fast_data_asap~eu-tenders-ted-api/runs": { "post": { "operationId": "runs-sync-fast_data_asap-eu-tenders-ted-api", "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/fast_data_asap~eu-tenders-ted-api/run-sync": { "post": { "operationId": "run-sync-fast_data_asap-eu-tenders-ted-api", "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", "type": "array", "description": "Full-text search terms (any language used in the notice, e.g. software, cloud, Reinigung). A notice matches if it contains ANY of the terms. Empty = no keyword filter.", "default": [], "items": { "type": "string" } }, "countries": { "title": "Buyer countries (ISO 3-letter)", "type": "array", "description": "Country of the contracting authority as ISO 3166 alpha-3 code, e.g. DEU, AUT, FRA, ITA, ESP, NLD, POL. 2-letter codes (DE, AT, FR) are converted automatically. Empty = all countries.", "default": [ "DEU" ], "items": { "type": "string" } }, "cpvCodes": { "title": "CPV code prefixes", "type": "array", "description": "Common Procurement Vocabulary prefixes, e.g. 72 (IT services), 48 (software packages), 45 (construction work), 79 (business services), 90 (cleaning/environment), 33 (medical equipment). A notice matches if any of its CPV codes starts with one of the prefixes.", "default": [ "72" ], "items": { "type": "string" } }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "competition = calls for tenders (contract notices, open opportunities), result = contract award notices (who won), planning = prior information notices, change = corrigenda/modifications. Empty = all.", "items": { "type": "string", "enum": [ "competition", "result", "planning", "change" ], "enumTitles": [ "Calls for tenders (competition)", "Contract award notices (result)", "Prior information (planning)", "Changes / corrigenda" ] }, "default": [ "competition" ] }, "publishedWithinDays": { "title": "Published within the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only notices published in the last N days. Use 1 or 2 for a daily alert. 0 = no date limit.", "default": 7 }, "deadlineAfter": { "title": "Deadline on or after (YYYY-MM-DD)", "pattern": "^$|^today$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only notices whose tender submission deadline is on or after this date, e.g. today to skip expired tenders. Use 'today' for the current date. Notices without a deadline are kept." }, "minValueEur": { "title": "Minimum estimated value", "minimum": 0, "type": "integer", "description": "Drop notices whose estimated value is known and lower than this amount (in the notice currency, normally EUR). Notices without a published value are kept." }, "language": { "title": "Preferred language for title/buyer", "enum": [ "en", "de", "fr", "es", "it", "nl", "pl", "pt", "sv", "da", "fi", "cs", "ro", "hu", "el", "bg", "sk", "sl", "hr", "lt", "lv", "et", "ga", "mt" ], "type": "string", "description": "Language used for title, buyer name and summary when the notice is multilingual. Falls back to English, then to the original language.", "default": "en" }, "maxResults": { "title": "Max notices", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of notices returned (and charged) per run.", "default": 20 }, "includeSummary": { "title": "Include short summary", "type": "boolean", "description": "Adds the procedure description (shortened to 500 characters) when TED provides it.", "default": true } } }, "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 } } } } } } } } } }