{ "openapi": "3.0.1", "info": { "title": "Singapore Bunker Demand & Tanker Flow Divergence", "description": "Compare official monthly Singapore bunker demand, tanker arrivals, fuel mix, and vessel calls in one evidence report. Add optional bounded BYOK tanker pressure, with publication lag, freshness, confidence, null reasons, provenance, gaps, and human review.", "version": "0.2", "x-build-id": "5krNuzaQwnFJpdKri" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zinin~singapore-bunker-tanker-divergence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zinin-singapore-bunker-tanker-divergence", "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/zinin~singapore-bunker-tanker-divergence/runs": { "post": { "operationId": "runs-sync-zinin-singapore-bunker-tanker-divergence", "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/zinin~singapore-bunker-tanker-divergence/run-sync": { "post": { "operationId": "run-sync-zinin-singapore-bunker-tanker-divergence", "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", "required": [ "schemaVersion" ], "properties": { "schemaVersion": { "title": "Schema version", "enum": [ "1.0" ], "type": "string", "description": "Contract version for this Actor input.", "default": "1.0" }, "requestId": { "title": "Request ID", "pattern": "^(auto|[A-Za-z0-9][A-Za-z0-9._:-]{0,127})$", "type": "string", "description": "Use auto for a Task-safe run identity.", "default": "auto" }, "watchId": { "title": "Watch ID", "pattern": "^[a-z0-9][a-z0-9._-]{2,63}$", "minLength": 3, "maxLength": 64, "type": "string", "description": "Stable identity for the Singapore baseline.", "default": "singapore-bunker-main" }, "sourceMode": { "title": "Source mode", "enum": [ "demo", "open", "open_plus_byok" ], "type": "string", "description": "Demo is synthetic; open uses data.gov.sg; open_plus_byok adds two bounded Datalastic provider requests: /stat plus Singapore. Prefill is demo because it is the only mode that reliably pushes a Dataset row on a console \"Start\" click without buyer configuration; open depends on a live data.gov.sg fetch clearing full-coverage gates and open_plus_byok additionally requires a paid key, so open remains the default for API buyers who already have working access.", "default": "open" }, "datalasticApiKey": { "title": "Datalastic API key", "type": "string", "description": "Only valid with sourceMode=open_plus_byok; runtime validation requires a printable 8-256 character secret, rejects it in demo/open, and never returns it." }, "baselineMonths": { "title": "Baseline months", "minimum": 3, "maximum": 12, "type": "integer", "description": "Historical window used for 3-month and 12-month comparisons.", "default": 12 }, "maxRows": { "title": "Rows per official source", "minimum": 240, "maximum": 500, "type": "integer", "description": "One bounded page per official source; 240 covers the observed 13-month window and up to 500 is allowed.", "default": 240 }, "maxProviderRequests": { "title": "Maximum provider requests", "minimum": 2, "maximum": 2, "type": "integer", "description": "Exactly two requests are permitted for BYOK: /stat plus the Singapore zone.", "default": 2 }, "maxTotalChargeUsd": { "title": "Maximum total charge (USD)", "minimum": 0.005, "maximum": 100, "type": "number", "description": "Buyer cap checked before the paid result event.", "default": 0.055 } } }, "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 } } }, "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 } } } } } } } } } }