{ "openapi": "3.0.1", "info": { "title": "Taiwan Director Compensation (TWSE + TPEx) — Board Pay", "description": "What every listed and OTC company in Taiwan paid its board last year, filed with the exchanges and never assembled until now. Parent-company and consolidated-group pay side by side, so what the subsidiaries paid is a subtraction. With EPS, ROE and profit on the same row.", "version": "0.1", "x-build-id": "IwALntW9z2DgVwdE6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chamarix~taiwan-director-compensation/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chamarix-taiwan-director-compensation", "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/chamarix~taiwan-director-compensation/runs": { "post": { "operationId": "runs-sync-chamarix-taiwan-director-compensation", "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/chamarix~taiwan-director-compensation/run-sync": { "post": { "operationId": "run-sync-chamarix-taiwan-director-compensation", "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": { "markets": { "title": "Markets", "type": "array", "description": "TWSE is the listed board (上市), TPEX the over-the-counter board (上櫃). Both boards publish the same four tables in the same shape.", "items": { "type": "string", "enum": [ "TWSE", "TPEX" ], "enumTitles": [ "TWSE — listed companies (上市)", "TPEX — OTC companies (上櫃)" ] }, "default": [ "TWSE", "TPEX" ] }, "roles": { "title": "Roles", "type": "array", "description": "Directors (董事) or supervisors (監察人). The supervisor tables are nearly empty — one listed and two OTC companies in the current edition — because audit committees have replaced supervisors almost everywhere. That is the state of the filing, not a failed fetch.", "items": { "type": "string", "enum": [ "director", "supervisor" ], "enumTitles": [ "director — 董事 (~1,830 companies)", "supervisor — 監察人 (a handful of companies)" ] }, "default": [ "director", "supervisor" ] }, "stockCodes": { "title": "Company codes filter", "type": "array", "description": "Optional list of company codes to keep, e.g. ['2330', '1101']. Matched as text, because codes are not all four digits — the TDR listings run to six ('911608').", "default": [], "items": { "type": "string" } }, "includeRationale": { "title": "Keep the filed rationale text", "type": "boolean", "description": "Each filing carries a free-text explanation of how pay relates to the year's profit, quoting the article of the company's own charter that sets the board's share. It is the longest field by far — past 1,000 characters for some filers — so turn this off for a compact dataset.", "default": true }, "includeRawFields": { "title": "Keep the official Chinese columns", "type": "boolean", "description": "Adds a `fields` object holding every column exactly as the exchange publishes it, under its original Chinese name and prefixed by scope. For auditing a value back to source.", "default": false }, "crossCheck": { "title": "Cross-check headcounts against the 董監持股 report", "type": "boolean", "description": "Divides each filed total by its filed average to recover how many people were paid, then compares that against the exchange's separate monthly 董監持股 filing and writes the agreement rate to the log. Exact agreement is not expected for every company — a board that turned over mid-year averages over months served — so this is a signal, not a gate. Costs one extra request.", "default": true } } }, "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 } } } } } } } } } }