{ "openapi": "3.0.1", "info": { "title": "EU Tenders (TED) Scraper", "description": "Use this when you need public tenders from the EU's TED (Tenders Electronic Daily): contract notices and awards by keyword, country, CPV code and date, with buyer, deadline, estimated value and link. Official API, incremental mode for daily runs. Pay per result.", "version": "0.1", "x-build-id": "yYTxy4Kvd8jsPF2R0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hexadatalabs~eu-tenders-ted-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hexadatalabs-eu-tenders-ted-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/hexadatalabs~eu-tenders-ted-scraper/runs": { "post": { "operationId": "runs-sync-hexadatalabs-eu-tenders-ted-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/hexadatalabs~eu-tenders-ted-scraper/run-sync": { "post": { "operationId": "run-sync-hexadatalabs-eu-tenders-ted-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": { "searchQueries": { "title": "Keywords", "type": "array", "description": "Full-text search over the whole notice, one phrase per line, e.g. \"software\", \"cloud\", \"road maintenance\". TED searches in the language of the notice, so an English word finds English notices plus titles that contain it; add translations to widen (\"Software\" is the same in German, \"logiciel\" in French). Leave empty to filter only by country / CPV / date.", "items": { "type": "string" } }, "countries": { "title": "Buyer countries", "type": "array", "description": "ISO 3166-1 alpha-2 codes of the buyer's country, e.g. DE, FR, ES, IT, NL, PL (alpha-3 like DEU also works). Empty = all countries publishing on TED (EU, EEA and others).", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Common Procurement Vocabulary codes, hierarchical: \"72000000\" = all IT services, \"45\" = all construction work, \"33600000\" = pharmaceuticals. A shorter prefix is padded with zeros. Find codes at https://ted.europa.eu/en/simap/cpv", "items": { "type": "string" } }, "noticeTypes": { "title": "Notice type", "enum": [ "all", "competition", "result", "planning", "direct-award", "modification" ], "type": "string", "description": "Use \"competition\" for open calls you can still bid on (contract notices), \"result\" for contract award notices with winner and amount, \"planning\" for prior information notices.", "default": "all" }, "dateFrom": { "title": "Published from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only notices published on TED on or after this date (YYYY-MM-DD), e.g. 2026-10-01. Empty = no lower bound (when no other filter is set, the last 7 days are used)." }, "dateTo": { "title": "Published until", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only notices published on or before this date (YYYY-MM-DD). Empty = today." }, "onlyNewSinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "Use this on a schedule: the Actor remembers when it last ran (shared store \"hexadata-eu-tenders-ted\" in your account) and returns only notices published since then that it has not delivered before. The first run saves everything that matches.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Stop after this many tenders. Newest notices come first. Above 15,000 the Actor switches to TED's iteration mode automatically.", "default": 100 }, "includeDetails": { "title": "Include lot details", "type": "boolean", "description": "Add per-lot data (lot title, description, value, deadline), submission and document URLs, contract duration, framework-agreement flag and number of tenders received. Same price per result; items are larger.", "default": false }, "includeRaw": { "title": "Include raw API notice", "type": "boolean", "description": "Attach the original TED API object under \"raw\" (all languages, all fields requested). Useful for debugging or custom parsing; makes items much bigger.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "TED is an open API that does not need a proxy; leave it off. Turn on Apify Proxy only if your runs are blocked from a specific region.", "default": { "useApifyProxy": 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 } } } } } } } } } }