{ "openapi": "3.0.1", "info": { "title": "Public Tenders Scraper", "description": "Procurement notices from TED, which covers the EU and the EEA, and from the UK's Find a Tender and Contracts Finder, all with the same fields. One input filters the three sources by country, CPV code, keyword, value or deadline, and scheduled runs can return only new notices.", "version": "0.1", "x-build-id": "d6VcfWKijbhzSY4YM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~public-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-public-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~public-tenders-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-public-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~public-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-public-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": "Which official services to read: ted for the EU journal covering all 27 member states plus the EEA, uk-fts for Find a Tender, where UK public buyers publish their procurement notices, and uk-cf for Contracts Finder, the UK government's list of contract opportunities. Both UK services carry contracts above and below the procurement thresholds. Leave empty to read all of them.", "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, every source 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: TED searches all its notices, and the UK services are read from their newest notice back." }, "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. On TED this is part of the search, so Maximum notices counts open notices. On the UK services it runs after reading and keeps only the tender, tenderUpdate and tenderAmendment stages. 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 changes TED rows only. 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 } } } } } } } } } }