{ "openapi": "3.0.1", "info": { "title": "World Bank Tender Deadline Watchdog", "description": "Watches the official World Bank procurement notice API for open Invitation-for-Bids and Expression-of-Interest tenders by country/sector keyword, and ranks each by days left to its real submission deadline with the buyer's direct contact.", "version": "0.1", "x-build-id": "osehqXgpVB4Wli9ds" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hllerdgn80~world-bank-tender-deadline-watchdog/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hllerdgn80-world-bank-tender-deadline-watchdog", "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/hllerdgn80~world-bank-tender-deadline-watchdog/runs": { "post": { "operationId": "runs-sync-hllerdgn80-world-bank-tender-deadline-watchdog", "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/hllerdgn80~world-bank-tender-deadline-watchdog/run-sync": { "post": { "operationId": "run-sync-hllerdgn80-world-bank-tender-deadline-watchdog", "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": { "keyword": { "title": "Sector / product keyword", "type": "string", "description": "Free-text keyword matched against the notice's title and description on the official World Bank procurement search (their own \"qterm\" parameter), e.g. \"solar\", \"road rehabilitation\", \"laboratory equipment\". Leave blank to pull every open notice for the selected country/countries instead." }, "countries": { "title": "Countries", "type": "array", "description": "Project country names exactly as the World Bank site spells them, e.g. \"Kenya\", \"Bangladesh\", \"Uganda\". Leave empty to search worldwide. Each country is queried separately and results are merged.", "items": { "type": "string" } }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Which official World Bank procurement notice types to include. \"Invitation for Bids\" and \"Request for Expressions of Interest\" are the two types that carry a real bidder submission deadline; \"General Procurement Notice\" is an early heads-up with no fixed deadline.", "items": { "type": "string", "enum": [ "Invitation for Bids", "Request for Expressions of Interest", "General Procurement Notice", "Specific Procurement Notice" ] }, "default": [ "Invitation for Bids", "Request for Expressions of Interest" ] }, "maxNoticesPerQuery": { "title": "Max notices fetched per country/type combination", "minimum": 5, "maximum": 500, "type": "integer", "description": "How many of the most recent notices to pull per (country, notice type) query from the World Bank API before deadline-filtering. The API returns newest-first, so a small number is normally enough; raise it if a country/sector has heavy tender volume and you want deeper coverage.", "default": 50 }, "minDaysLeft": { "title": "Minimum days left to include", "minimum": -365, "maximum": 365, "type": "integer", "description": "Drop notices whose submission deadline has already passed or is closer than this many days - set to a negative number (e.g. -1) to keep already-expired notices too, for historical analysis.", "default": 0 }, "urgentWithinDays": { "title": "\"Urgent\" threshold (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "A notice is labelled risk_level URGENT when its deadline is this many days away or closer, WATCH when further out but inside double this window, and OPEN otherwise.", "default": 7 } } }, "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 } } } } } } } } } }