{ "openapi": "3.0.1", "info": { "title": "EU & UK Public Tenders Scraper - TED & Find a Tender", "description": "Search public procurement tenders and contract awards from TED (EU), UK Find a Tender and Contracts Finder in one clean format. Filter by keyword, CPV code, country, value and deadline. Official open data, no API key. Ideal for daily tender alerts.", "version": "1.0", "x-build-id": "EwbrBeYMoRNCAj7sb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cazadores~government-tenders/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cazadores-government-tenders", "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/cazadores~government-tenders/runs": { "post": { "operationId": "runs-sync-cazadores-government-tenders", "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/cazadores~government-tenders/run-sync": { "post": { "operationId": "run-sync-cazadores-government-tenders", "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": { "noticeType": { "title": "Notice type", "enum": [ "tenders", "awards", "all" ], "type": "string", "description": "'tenders' = open calls for tender (contract opportunities you can bid on). 'awards' = contract award notices (who won, for how much). 'all' = both.", "default": "tenders" }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional. Returns notices containing ANY of these words or phrases, in title or description (e.g. 'software', 'cloud hosting', 'road maintenance'). TED notices are in the buyer's language, so add translations for wider coverage (e.g. 'Software', 'logiciel').", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Optional. EU procurement category codes. Codes are hierarchical: '72000000' or '72' matches all IT services, '45' all construction work, '33' medical equipment. Returns notices with ANY matching code.", "items": { "type": "string" } }, "countries": { "title": "Buyer countries", "type": "array", "description": "Optional. 2-letter country codes of the buying authority, e.g. DE, FR, ES, IT, PL, GB. TED covers the EU/EEA; the UK sources cover GB. Leave empty for all.", "items": { "type": "string" } }, "publishedFrom": { "title": "Published from", "type": "string", "description": "First publication date to include, YYYY-MM-DD. Leave both dates empty for the last 7 days: combined with 'Only new notices', a daily or weekly schedule gets every notice exactly once, even after weekends and holidays." }, "publishedTo": { "title": "Published to", "type": "string", "description": "Last publication date to include (inclusive), YYYY-MM-DD. Leave empty for today. Max range: 366 days." }, "onlyOpen": { "title": "Only tenders still open", "type": "boolean", "description": "If true (default), skips tenders whose submission deadline has already passed. Tenders without a published deadline are kept. Doesn't affect awards.", "default": true }, "onlyNew": { "title": "Only new notices (skip already delivered)", "type": "boolean", "description": "Skip notices already returned by a previous run of the same search, so you never pay twice for the same notice (the list is kept in your own Apify account). Default: ON when both dates are empty (alert mode), OFF when you set a date range. Set it explicitly to override." }, "minValue": { "title": "Minimum value", "minimum": 0, "type": "integer", "description": "Optional. Only notices with an estimated (tenders) or awarded (awards) value of at least this amount, in the notice's own currency. Notices without a published value are excluded when this is set." }, "sources": { "title": "Sources", "type": "array", "description": "Which official databases to search. Default: all three.", "items": { "type": "string", "enum": [ "ted", "uk-find-a-tender", "uk-contracts-finder" ], "enumTitles": [ "TED - EU/EEA (Tenders Electronic Daily)", "UK Find a Tender (above threshold)", "UK Contracts Finder (lower value)" ] }, "default": [ "ted", "uk-find-a-tender", "uk-contracts-finder" ] }, "maxItems": { "title": "Max notices", "minimum": 1, "type": "integer", "description": "Maximum number of notices to return in total. You are charged per notice returned. TED alone publishes about 1,700 open tenders per working day, so use filters or this limit to control cost.", "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 } } } } } } } } } }