{ "openapi": "3.0.1", "info": { "title": "Korea Commercial Property Sales - Official Transaction Register", "description": "Every reported sale of retail, office, hospitality and other commercial property in Korea, straight from the government register. Price, building and land area, zoning, use class, buyer and seller type, with price per pyeong calculated. Search by district name instead of hunting for codes.", "version": "0.1", "x-build-id": "zq14ZxYuK08MbTiFd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/loopchips~korea-commercial-trades/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-loopchips-korea-commercial-trades", "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/loopchips~korea-commercial-trades/runs": { "post": { "operationId": "runs-sync-loopchips-korea-commercial-trades", "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/loopchips~korea-commercial-trades/run-sync": { "post": { "operationId": "run-sync-loopchips-korea-commercial-trades", "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": [ "serviceKey", "districts" ], "properties": { "serviceKey": { "title": "data.go.kr service key", "type": "string", "description": "Your own free key from data.go.kr. Search for 상업업무용 부동산 매매 실거래가 자료 and press 활용신청 - approval is automatic and gives 10,000 calls a day. Paste the Encoding key." }, "districts": { "title": "Districts", "type": "array", "description": "District names such as \"서울 강남구\" or \"강남구\", or five-digit codes such as 11680. Names are resolved for you.", "default": [ "서울 강남구" ], "items": { "type": "string" } }, "startMonth": { "title": "Start month", "type": "string", "description": "YYYYMM, for example 202601. Defaults to the current month." }, "endMonth": { "title": "End month", "type": "string", "description": "YYYYMM. Defaults to the start month, so leaving both empty returns this month only." }, "buildingTypes": { "title": "Use classes", "type": "array", "description": "Keep only these 건물주용도 values, for example 판매 for retail or 업무 for office. Leave empty for every use class.", "items": { "type": "string", "enum": [ "제1종근린생활", "제2종근린생활", "판매", "업무", "숙박", "교육연구", "의료", "운동", "위락", "공장", "창고", "기타" ] }, "default": [] }, "includeCancelled": { "title": "Include cancelled deals", "type": "boolean", "description": "Cancelled contracts are excluded by default so averages are not distorted.", "default": false }, "excludeShareDeals": { "title": "Exclude part-share deals", "type": "boolean", "description": "A 지분 deal sells a fraction of a property, so its price does not match the area on the same row. They are kept by default and flagged, with per-pyeong figures left empty.", "default": false }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Pause between requests so the source is not hit too quickly.", "default": 400 } } }, "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 } } } } } } } } } }