{ "openapi": "3.0.1", "info": { "title": "Taiwan Real Estate Actual Price Registration (實價登錄) Search", "description": "Filterable, English-keyed Taiwan property sale, presale and rental transaction prices from the Ministry of the Interior open data (OGDL-TW 1.0).", "version": "0.0", "x-build-id": "02UhaJe8VNXZlXNOQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/waisuan~taiwan-real-price-registration/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-waisuan-taiwan-real-price-registration", "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/waisuan~taiwan-real-price-registration/runs": { "post": { "operationId": "runs-sync-waisuan-taiwan-real-price-registration", "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/waisuan~taiwan-real-price-registration/run-sync": { "post": { "operationId": "run-sync-waisuan-taiwan-real-price-registration", "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": { "seasons": { "title": "Seasons (ROC year + S + quarter)", "type": "array", "description": "e.g. 115S3 = 2026 Q3. Leave empty to auto-detect the latest published season.", "default": [], "items": { "type": "string" } }, "counties": { "title": "Counties / cities", "type": "array", "description": "County codes used by MOI.", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "M", "N", "O", "P", "Q", "T", "U", "V", "W", "X", "Z" ], "enumTitles": [ "Taipei 臺北市", "Taichung 臺中市", "Keelung 基隆市", "Tainan 臺南市", "Kaohsiung 高雄市", "New Taipei 新北市", "Yilan 宜蘭縣", "Taoyuan 桃園市", "Chiayi City 嘉義市", "Hsinchu County 新竹縣", "Miaoli 苗栗縣", "Nantou 南投縣", "Changhua 彰化縣", "Hsinchu City 新竹市", "Yunlin 雲林縣", "Chiayi County 嘉義縣", "Pingtung 屏東縣", "Hualien 花蓮縣", "Taitung 臺東縣", "Kinmen 金門縣", "Penghu 澎湖縣", "Lienchiang 連江縣" ] }, "default": [ "A" ] }, "transactionTypes": { "title": "Transaction types", "type": "array", "description": "Transaction types.", "items": { "type": "string", "enum": [ "sale", "presale", "lease" ], "enumTitles": [ "Sale 買賣", "Presale 預售屋", "Lease 租賃" ] }, "default": [ "sale" ] }, "districts": { "title": "Districts (Chinese, exact)", "type": "array", "description": "e.g. 大安區. Empty = all.", "default": [], "items": { "type": "string" } }, "buildingTypeContains": { "title": "Building type contains", "type": "string", "description": "e.g. 住宅大樓, 公寓, 透天厝", "default": "" }, "minTotalPrice": { "title": "Min total price (TWD)", "minimum": 0, "type": "integer", "description": "Min total price (TWD)." }, "maxTotalPrice": { "title": "Max total price (TWD)", "minimum": 0, "type": "integer", "description": "Max total price (TWD)." }, "dateFrom": { "title": "Transaction date from (YYYY-MM-DD)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Transaction date from (YYYY-MM-DD).", "default": "" }, "dateTo": { "title": "Transaction date to (YYYY-MM-DD)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Transaction date to (YYYY-MM-DD).", "default": "" }, "excludeSpecialRelations": { "title": "Exclude related-party deals", "type": "boolean", "description": "Drop transactions noted as between relatives, employees, co-owners or other special relations.", "default": true }, "addressPrecision": { "title": "Address precision", "enum": [ "road", "full" ], "type": "string", "description": "Address precision.", "default": "road" }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Max results.", "default": 1000 }, "requestDelayMs": { "title": "Delay between downloads (ms)", "minimum": 1000, "maximum": 30000, "type": "integer", "description": "Delay between downloads (ms).", "default": 1500 } } }, "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 } } } } } } } } } }