{ "openapi": "3.0.1", "info": { "title": "Kenya PPIP Tender Scraper", "description": "Extract Kenyan public tenders and contract awards from the Public Procurement Information Portal (tenders.go.ke): active, closed, AGPO and terminated tenders, procuring entity, dates, documents, awarded supplier and contract amount.", "version": "0.0", "x-build-id": "RPOnr9wCukj4s7tGu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/publicmoney~kenya-ppip-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-publicmoney-kenya-ppip-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/publicmoney~kenya-ppip-scraper/runs": { "post": { "operationId": "runs-sync-publicmoney-kenya-ppip-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/publicmoney~kenya-ppip-scraper/run-sync": { "post": { "operationId": "run-sync-publicmoney-kenya-ppip-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": { "mode": { "title": "📂 Mode", "enum": [ "active", "closed", "agpo", "terminated", "all", "awards" ], "type": "string", "description": "Which portal list to read. Tender modes return tender notices; 'awards' returns published contract awards with the awarded supplier and amount.", "default": "active" }, "title": { "title": "🔍 Title contains", "type": "string", "description": "Server-side filter on the tender title (in 'awards' mode, the title of the awarded tender). Substring match. Example: 'supply'." }, "tenderRef": { "title": "🔖 Tender reference contains", "type": "string", "description": "Server-side filter on the tender reference number. Substring match. Example: 'AWD/AWARD'." }, "procuringEntity": { "title": "🏛️ Procuring entity contains", "type": "string", "description": "Server-side filter on the procuring entity name. Substring match. Examples: 'Judiciary', 'AWENDO NGCDF'." }, "procurementMethod": { "title": "⚖️ Procurement method contains", "type": "string", "description": "Server-side filter on the procurement method title. Example: 'Open Tender'." }, "procurementCategory": { "title": "🏷️ Procurement category contains", "type": "string", "description": "Server-side filter on the procurement category title. Examples: 'Goods', 'Works'." }, "financialYear": { "title": "📅 Financial year", "type": "string", "description": "Server-side filter on the Kenyan financial year (July to June), written as the portal writes it. Example: '2025/2026'." }, "publishedDate": { "title": "🗓️ Published date contains (tender modes)", "type": "string", "description": "Tender modes only. Server-side substring match on the publication timestamp 'YYYY-MM-DD hh:mm:ss', so '2026-09' is a month and '2026-09-21' a day." }, "closingDate": { "title": "⏰ Closing date contains (tender modes)", "type": "string", "description": "Tender modes only. Server-side substring match on the closing timestamp 'YYYY-MM-DD hh:mm:ss'. Example: '2026-10-05'." }, "supplierName": { "title": "🏢 Supplier name contains (awards)", "type": "string", "description": "'awards' mode only. Server-side substring match on the awarded supplier's name." }, "contractNumber": { "title": "📄 Contract number contains (awards)", "type": "string", "description": "'awards' mode only. Server-side substring match on the contract number. Example: 'PO 26/27'." }, "awardDate": { "title": "🏆 Award date contains (awards)", "type": "string", "description": "'awards' mode only. Server-side substring match on the award date 'YYYY-MM-DD'. Example: '2026-09'." }, "maxItems": { "title": "🔢 Max items", "minimum": 0, "type": "integer", "description": "Maximum number of records to return. 0 returns everything matched. Examples: 1, 500, 2000. Default is 500.", "default": 500 }, "schemaOrg": { "title": "🔗 Add schema.org block", "type": "boolean", "description": "Appends a `schemaOrg` object to the end of every record, mapping it to schema.org (Demand for tenders, MonetaryGrant for grants, Invoice for payments). The record's own fields are not changed. Off by default. Charged once per run, not per record.", "default": false } } }, "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 } } } } } } } } } }