본문으로 이동
Ganglou Zhihuicommercialisation.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입니다. 키는 철회할 수 있습니다.

공개 항목

매물 번호, 단지, 권역, 지역, 홍콩달러 참고가, 전용 면적당 가격, 세대 설명, 전용 면적, 구조, 층, 특징, 주변, 사진 URL, 매매 구분, 갱신 시각. 소유자 이름, 전화, 이메일, 등록 기록은 포함하지 않습니다.

공식 자료 갱신

Rating and Valuation Department, Land Registry, Education Bureau, data.gov.hk 의 공개 파일을 일정에 따라 받아 기존 Neon 데이터베이스에 출처 URL과 날짜와 함께 저장합니다. 시세 데이터 페이지는 그 출처를 계속 밝힙니다. 이 API는 원본 파일을 대량으로 다시 싣지 않습니다.

개인정보

이 API는 소유자나 관심 등록자의 개인정보를 제공하지 않습니다. 접근 기록에는 호출 주소의 해시, 키 앞부분, 경로, 상태 코드만 저장하고 원래 네트워크 주소는 저장하지 않습니다. API 키는 파트너 자격 증명이지 소유자 기록이 아닙니다. 개인정보 처리는 Personal Data (Privacy) Ordinance 의 적용을 받습니다. 공식 본문은 Privacy Commissioner 사이트에 있습니다.

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 문의