{ "openapi": "3.0.1", "info": { "title": "EU Tenders Scraper: TED Contract Awards and Winners", "description": "Returns EU public procurement notices from TED: contract awards with the winning company, buyer, value in EUR, CPV and date, plus open tenders with deadlines. Filter by country, CPV, keyword and value. Daily mode returns only new records.", "version": "1.0", "x-build-id": "vnnTsci16e5z69R6g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/agents001~eu-ted-tenders-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-agents001-eu-ted-tenders-feed", "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/agents001~eu-ted-tenders-feed/runs": { "post": { "operationId": "runs-sync-agents001-eu-ted-tenders-feed", "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/agents001~eu-ted-tenders-feed/run-sync": { "post": { "operationId": "run-sync-agents001-eu-ted-tenders-feed", "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": { "mode": { "title": "What to return", "enum": [ "awards", "tenders", "both" ], "type": "string", "description": "Contract awards give one record per winning company (buying signals). Open tenders give one record per call for competition with its deadline. Both returns both record types.", "default": "awards" }, "daysBack": { "title": "Published in the last N publishing days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Publication date window in TED publishing days (Monday to Friday), counting today. 3 on a Monday covers Thursday, Friday and Monday. Ignored when you set a start date below.", "default": 3 }, "dateFrom": { "title": "Published from (optional)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "First publication date, for example 2026-10-01. Leave empty to use 'Published in the last N days'." }, "dateTo": { "title": "Published until (optional)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Last publication date, for example 2026-10-15. Leave empty for today." }, "countries": { "title": "Buyer countries", "type": "array", "description": "Only notices whose buyer is in one of these countries. Use 2 or 3 letter ISO codes (DE, DEU) or English names (Germany). Leave empty for all countries.", "items": { "type": "string" } }, "winnerCountries": { "title": "Winner countries (awards only)", "type": "array", "description": "Only winning companies from these countries, for example your sales territory. Same formats as buyer countries.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Only notices with one of these CPV codes or any code below it. 72000000 covers all IT services, 48000000 all software packages, 45000000 all construction work. Short codes such as 72 are padded to 72000000.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Only notices whose text contains any of these keywords. Inside one keyword every word must appear. A trailing * matches word endings, for example softw*. TED also searches its own translations of the CPV descriptions, so English words find many notices in other languages.", "items": { "type": "string" } }, "minValueEur": { "title": "Minimum value (EUR)", "minimum": 0, "type": "number", "description": "Only records whose value, converted to euro with the latest ECB reference rates, is at least this much. Records without a published value are dropped when this is above 0. For awards the value is the notice total across all lots and winners.", "default": 0 }, "onlyOpen": { "title": "Only tenders still open", "type": "boolean", "description": "Drop tenders whose submission or participation deadline has already passed. Tenders without a published deadline are kept.", "default": true }, "onlyNew": { "title": "Only records not returned in previous runs", "type": "boolean", "description": "Remember which records were already returned for these filters and only return new ones. The date window is not part of the history, so a daily run with a 3 day window never repeats a record. Changing the mode or filters starts a fresh history.", "default": false }, "maxItems": { "title": "Maximum records", "minimum": 0, "type": "integer", "description": "Stop after this many records in total, newest notices first. 0 means no limit. In 'both' mode tenders get half and awards get the rest. You pay per record returned.", "default": 1000 }, "stateStoreName": { "title": "State store name", "pattern": "^[a-zA-Z0-9-]{1,63}$", "type": "string", "description": "Only used when 'Only records not returned in previous runs' is on. Name of the key-value store in your account that keeps the list of records already returned. Each different set of filters gets its own record inside it. Change it only to keep separate histories. If a run reports that it cannot open the store, enter a different name here.", "default": "agents001-eu-ted-tenders-feed-state" }, "requestDelaySecs": { "title": "Delay between requests", "minimum": 0.2, "maximum": 10, "type": "number", "description": "Minimum seconds between requests to the TED API. TED's fair usage policy allows far more; keep this polite.", "default": 0.3 } } }, "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 } } } } } } } } } }