{ "openapi": "3.0.1", "info": { "title": "EU Tenders Scraper", "description": "Contract notices from TED, the EU's official procurement journal, with buyer, deadline, value and CPV codes for the 27 member states plus Iceland, Liechtenstein, Norway and Switzerland. Filter by country, CPV code, keyword or notice type, and schedule runs that return only new notices.", "version": "0.1", "x-build-id": "qMcK2XTuwvjK1aMhN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~eu-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-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/deriverge~eu-tenders-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-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/deriverge~eu-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-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": { "sources": { "title": "Sources", "type": "array", "description": "This actor covers the European Union journal TED (ted). Leave empty to read all of them. Sources outside this actor are skipped and listed in the run summary; the multi-source actor covers those.", "items": { "type": "string" } }, "countries": { "title": "Buyer countries", "type": "array", "description": "Two-letter country codes of the contracting authority, for example DE, FR, PL, NL. Leave empty for every country the sources cover.", "items": { "type": "string" } }, "cpv": { "title": "CPV codes", "type": "array", "description": "Common Procurement Vocabulary codes, the official taxonomy of what is being bought. Use the eight-digit code, for example 72000000 for IT services or 45000000 for construction. A division code matches everything inside it.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Full text search over the notice. Any of the words is enough to keep a notice. Leave empty to rely on the CPV codes instead.", "items": { "type": "string" } }, "publishedFrom": { "title": "Published from (YYYY-MM-DD)", "type": "string", "description": "First publication date to include. With both dates and Deadline on or after left empty, the run covers the last seven days." }, "publishedTo": { "title": "Published to (YYYY-MM-DD)", "type": "string", "description": "Last publication date to include, inclusive." }, "deadlineAfter": { "title": "Deadline on or after (YYYY-MM-DD)", "type": "string", "description": "Keep only notices whose deadline for receipt of tenders falls on or after this date. This is the filter that separates contracts you can still bid for from the archive. Set without publication dates, it replaces the seven-day default and searches all of TED." }, "onlyOpen": { "title": "Only notices you can still bid for", "type": "boolean", "description": "Drops award notices and notices whose deadline has passed; notices without a deadline stay. The filter is part of the TED search, so Maximum notices counts open notices. Notices removed by this filter are never charged.", "default": false }, "minValue": { "title": "Minimum contract value", "type": "integer", "description": "Keep only notices whose published value is at least this much, in the currency the source publishes. Notices with no published value are kept, because an absent value is not a small one." }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Restrict the EU journal to certain notice types, for example cn-standard for a contract notice or can-standard for a contract award notice. Leave empty for all of them.", "items": { "type": "string" } }, "language": { "title": "Preferred language", "type": "string", "description": "Two-letter code of an EU language, for example en, de or fr. It picks the language of the country and subject that TED puts at the start of every title, which TED has in all 24 EU languages, and of the PDF in documentsUrl. The rest of the title, the description and the buyer name exist only in the languages the buyer published, which languagesAvailable lists. They come in your language when the buyer published it, otherwise in English or in the buyer's own language.", "default": "en" }, "newOnly": { "title": "Return only notices new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only notices that were not there before or whose deadline or status moved. A tender has a short deadline, so a scheduled watch is worth more than a one-off export.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"it-services-germany\". Runs from a saved task get a snapshot automatically even without a name." }, "maxItems": { "title": "Maximum notices", "minimum": 1, "type": "integer", "description": "Hard cap on returned notices across all sources in the run.", "default": 1000 } } }, "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 } } } } } } } } } }