{ "openapi": "3.0.1", "info": { "title": "HK Land Registry — Property Transaction Records", "description": "Scrape Hong Kong Land Registry memorial day book — every Assignment, Mortgage, Charge, DMC, Release. Filter by 18 HK districts, memorial type, consideration HKD. For conveyancing, bank lien checks, journalists. Centaline / Midland / Spacious / EPRC alternative.", "version": "0.0", "x-build-id": "gzPct55rPmQnMeNLA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~hk-land-registry-transactions/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-hk-land-registry-transactions", "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/nexgendata~hk-land-registry-transactions/runs": { "post": { "operationId": "runs-sync-nexgendata-hk-land-registry-transactions", "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/nexgendata~hk-land-registry-transactions/run-sync": { "post": { "operationId": "run-sync-nexgendata-hk-land-registry-transactions", "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": { "searchType": { "title": "Search type", "enum": [ "memorial_day_book", "property_history" ], "type": "string", "description": "Which Hong Kong Land Registry (LR) lookup to perform. 'memorial_day_book' returns daily-summary entries from the LR Memorial Day Book — every memorial (legal document) registered against Hong Kong real property on a given day, including Assignments (property transfers), Charges / Mortgages (loans secured against land), Deeds of Mutual Covenant (DMC), Modifications, and Releases. This is the canonical record of every property transaction registered in Hong Kong. 'property_history' takes a specific Property Reference Number (PRN) and returns the full memorial history attached to that property — every transfer, mortgage, discharge, charge variation, and DMC since first registration. Per-property history queries against the IRIS (Integrated Registration Information System) endpoint typically require a paid LR account (search fee HKD 10-40 per query); the actor will return a `_blocked` placeholder if the gating page is reached.", "default": "memorial_day_book" }, "dateRange": { "title": "Date range (memorial registration date)", "type": "object", "description": "Memorial registration date window — 'from' and 'to' as 'YYYY-MM-DD' strings (e.g. {'from': '2026-04-01', 'to': '2026-04-07'}). The HK Land Registry indexes memorials by registration date (the date the LR clerk accepts the lodgement), NOT the contract execution date. LR publishes day-book summaries with a 3-7 working-day lag. For memorial_day_book mode, the date range bounds which days' summaries are pulled — wider ranges return more memorials but cost more (one record per memorial). For property_history mode, the range optionally bounds the returned timeline (defaults to all history when omitted).", "default": { "from": "2026-05-01", "to": "2026-05-07" } }, "propertyReference": { "title": "Property Reference Number (PRN, optional, property_history mode only)", "type": "string", "description": "Hong Kong Land Registry Property Reference Number — the canonical identifier the LR assigns to each registered property. Format varies (lot/section/subsection notation for New Territories, e.g. 'NKIL 6312', or building-and-unit references for urban strata-title, e.g. 'TM-12345-Flat-A-23/F'). Used only when 'searchType' is 'property_history'. Leave empty for memorial_day_book mode. If supplied without a paid LR account, the IRIS gating page is hit and the actor returns a `_blocked: true` placeholder with the gating reason." }, "district": { "title": "Hong Kong district (optional filter)", "enum": [ "ALL", "Central and Western", "Wan Chai", "Eastern", "Southern", "Yau Tsim Mong", "Sham Shui Po", "Kowloon City", "Wong Tai Sin", "Kwun Tong", "Kwai Tsing", "Tsuen Wan", "Tuen Mun", "Yuen Long", "North", "Tai Po", "Sha Tin", "Sai Kung", "Islands" ], "type": "string", "description": "Optional district filter for memorial_day_book mode — applied client-side after the day-book is fetched. HK is divided into 18 districts across HK Island (Central & Western, Wan Chai, Eastern, Southern), Kowloon (Yau Tsim Mong, Sham Shui Po, Kowloon City, Wong Tai Sin, Kwun Tong), and New Territories (Kwai Tsing, Tsuen Wan, Tuen Mun, Yuen Long, North, Tai Po, Sha Tin, Sai Kung, Islands). 'ALL' returns every district. Property concentration: Central & Western + Wan Chai + Eastern + Yau Tsim Mong cover the majority of high-value urban transactions; Yuen Long + Sai Kung + Islands cover most of the NT village-house and luxury low-rise activity.", "default": "ALL" }, "memorialType": { "title": "Memorial type filter (optional)", "enum": [ "ALL", "Assignment", "Mortgage", "Charge", "Deed of Mutual Covenant", "Modification", "Release", "Discharge", "Power of Attorney" ], "type": "string", "description": "Restrict to a specific memorial type. 'ALL' returns every memorial in the day-book window. 'Assignment' is the canonical sale / transfer of property (the 'sold' record). 'Mortgage' / 'Charge' are loans secured against the property (useful for bank-side loan due diligence and lien checks). 'Deed of Mutual Covenant' (DMC) is the foundational document for strata-title buildings. 'Modification' / 'Release' / 'Discharge' are subsequent amendments and lien releases. 'Power of Attorney' captures conveyancing-related POAs. Most journalists, real-estate analysts, and conveyancing lawyers want 'Assignment' (transfers) and 'Mortgage' (bank loans); banks running portfolio-level lien due diligence typically want 'Charge', 'Release', and 'Discharge'.", "default": "ALL" }, "minConsiderationHkd": { "title": "Minimum consideration (HKD, optional)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Lower bound on the consideration (transaction value) in Hong Kong Dollars. Filters client-side. Set to 30000000 for luxury (HKD 30M+ — the segment Centaline / Midland Realty / Savills HK tag as 'luxury residential'). Set to 100000000 for ultra-prime (Peak, Repulse Bay, Stanley, Mid-Levels Conduit Road / Magazine Gap Road). Leave 0 for no lower bound. Note: many memorial types (mortgages, releases, DMC, modifications) do not have a 'consideration' — those records' `consideration_hkd` field is null and they pass through this filter only if min is 0.", "default": 0 }, "limit": { "title": "Max records returned", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on records returned in this run (1-2000). Each record is one HK Land Registry memorial. Per-record pricing applies — premium institutional-real-estate / conveyancing-lawyer / bank-due-diligence tier. Most recent memorials are returned first (sorted by registration_date descending). A typical day-book window of one week returns 5,000-15,000 memorials Hong Kong wide before filters; tight filters (district + memorial type + min consideration) typically narrow to a few hundred.", "default": 50 } } }, "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 } } } } } } } } } }