跳到內容
港樓智匯commercialisation.ai
WhatsApp 9739 8018

國際氛圍畫面，並非客戶案例。

返回目錄

API

API 文件

目錄小幫手只接受一個 POST。樓盤問題只根據本站出售目錄回答。指數變化同參考印花稅只根據已發布的樓市數據同同一套稅階。它唔會預測樓價，亦不是投資建議。

POST /api/chat

POST /api/chat，Content-Type 為 application/json。正文不得超過 8000 個字元。程式讀取 message、locale、propertyId 同 state。locale 可以是 zh-Hant、zh-Hans、en、ja 或 ko；沒有寫時用 zh-Hant。

成功時回傳 JSON：reply、listings、suggestions、state、whatsapp_url。正文過大是 413，JSON 不正確是 400。回應帶 cache-control: no-store。

合作夥伴

合作夥伴 API 說明

這個 API 把本站已經公開的出售盤欄位提供給已獲發 API 金鑰的合作夥伴。回應只包含目錄上的公開欄位。

2026-10-13 · OpenAPI 2026-10-13

OpenAPI

機器可讀的規格在 /api/v1/openapi。下面是同一份規格的閱讀版。

/api/v1/openapi

金鑰與限速

每次請求都要在 Authorization 標頭帶上 Bearer 金鑰。金鑰只在建立時顯示一次，資料庫保存的是雜湊。每個金鑰每小時有請求上限，超過會收到 429。金鑰可以撤銷。

公開欄位

物業編號、屋苑、分區、地區、港幣參考價、實用呎價、單位描述、實用面積、間隔、樓層、亮點、附近描述、相片網址、出售狀態同更新日期。沒有業主姓名、電話、電郵或其他登記資料。

官方資料更新

差餉物業估價署、土地註冊處、教育局同 data.gov.hk 的公開檔案由伺服器定時下載，寫入現有的 Neon 資料庫，並記下來源網址同日期。樓市數據中心頁面仍然引用這些來源。合作夥伴 API 不提供這些原始檔的大量轉載。

個人資料

這個 API 不提供業主或登記讀者的個人資料。存取日誌只保存呼叫位址的雜湊、金鑰前綴、路徑同狀態碼，不保存原始網絡位址。API 金鑰是合作夥伴的憑證，不是樓盤業主的資料。個人資料的處理仍受《個人資料（私隱）條例》約束，正式文本以個人資料私隱專員公署的頁面為準。

pcpd.org.hk

使用條款

價錢是目錄參考價，紀錄可以更改。回應不是估值、不是投資意見、不是要約，亦不是合約。使用時請註明來源為 commercialisation.ai。金鑰只供獲發的一方使用，本站可以撤銷金鑰或調整限速。請勿把回應描述成證券或代幣的銷售。

OpenAPI

{
  "openapi": "3.0.3",
  "info": {
    "title": "commercialisation.ai partner listings",
    "version": "2026-10-13",
    "description": "Sale catalog reference prices in HKD for browsing. Records can change. This response is not a valuation, not investment advice, and not an offer or a contract."
  },
  "servers": [
    {
      "url": "https://commercialisation.ai"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/api/v1/listings": {
      "get": {
        "operationId": "listListings",
        "summary": "List public sale listings",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of public listing fields"
          },
          "401": {
            "description": "Missing or unknown API key"
          },
          "429": {
            "description": "Rate limit"
          }
        }
      }
    },
    "/api/v1/listings/{id}": {
      "get": {
        "operationId": "getListing",
        "summary": "Read one public sale listing",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^M\\d+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "One public listing"
          },
          "404": {
            "description": "Unknown id"
          }
        }
      }
    }
  },
  "x-public-fields": [
    "propertyId",
    "estate",
    "sectionId",
    "districtZh",
    "districtEn",
    "priceHkd",
    "pricePerSqftHkd",
    "unitZh",
    "saleableSqft",
    "layoutZh",
    "layoutEn",
    "floorZh",
    "floorEn",
    "highlightsZh",
    "nearbyZh",
    "photos",
    "listingType",
    "updatedAt"
  ],
  "x-listing-property-types": {
    "propertyId": {
      "type": "string"
    },
    "estate": {
      "type": "string"
    },
    "sectionId": {
      "type": "string"
    },
    "districtZh": {
      "type": "string"
    },
    "districtEn": {
      "type": "string"
    },
    "priceHkd": {
      "type": "string"
    },
    "pricePerSqftHkd": {
      "type": "string"
    },
    "unitZh": {
      "type": "string"
    },
    "saleableSqft": {
      "type": "string"
    },
    "layoutZh": {
      "type": "string"
    },
    "layoutEn": {
      "type": "string"
    },
    "floorZh": {
      "type": "string"
    },
    "floorEn": {
      "type": "string"
    },
    "highlightsZh": {
      "type": "string"
    },
    "nearbyZh": {
      "type": "string"
    },
    "photos": {
      "type": "string"
    },
    "listingType": {
      "type": "string"
    },
    "updatedAt": {
      "type": "string"
    }
  }
}
WhatsApp 查詢