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。密钥可以撤销。

公开栏位

物业编号、屋苑、分区、地区、港币参考价、实用呎价、单位描述、实用面积、间隔、楼层、亮点、附近描述、相片网址、出售状态和更新日期。没有业主姓名、电话、电邮或其他登记资料。

propertyId
estate
sectionId
districtZh
districtEn
priceHkd
pricePerSqftHkd
unitZh
saleableSqft
layoutZh
layoutEn
floorZh
floorEn
highlightsZh
nearbyZh
photos
listingType
updatedAt

官方资料更新

差饷物业估价署、土地注册处、教育局和 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"
    }
  }
}