香港中原地產＋28Hse 爬蟲｜樓盤搜尋、物業詳情一鍵下載（免 API、免登入）

抓取香港中原地產（hk.centanet.com）及 28Hse（28hse.com）的公開物業資料，一個 Actor 涵蓋兩個最大港產放盤平台。支援關鍵字搜尋（買盤/租盤）、中原樓盤詳情、中原成交紀錄、中原城市領先指數（CCL）四種模式，全程走公開 JSON/HTML API，不需登入、不需帳號、不需 API token。

---

輸出欄位（search / detail）

欄位	類型	說明
property_id	string	物業唯一編號（中原 refNo 或 28Hse ID）
source_site	string	資料來源：centanet 或 28hse
title	string | null	樓盤標題（屋苑 + 大廈名）
district	string | null	地區（如：太古城、九龍城）
address	string | null	街道地址
estate_name	string | null	屋苑名稱
deal_type	string	buy（買盤）或 rent（租盤）
price	number | null	售價（港幣，買盤才有）
rent	number | null	月租（港幣，租盤才有）
currency	string	固定 HKD
area_sqft	number | null	建築面積（平方呎）
area_saleable	number | null	實用面積（平方呎）
price_per_sqft	number | null	呎價（港幣 / 平方呎）
room_layout	string | null	房間數，如 2 Bedrooms、Studio
floor	string | null	樓層描述，如 高層 F室
direction	string | null	朝向，如 西南
building_age	number | null	樓齡（年）
agent_name	string | null	代理姓名
agent_phone	string | null	代理電話
image_urls	string[]	物業圖片 URL 陣列
property_url	string	物業詳情頁面網址
source_mode	string	search 或 detail
source_query	string	搜尋關鍵字或物業 ID
scraped_at	string	抓取時間（ISO 8601）

---

輸出欄位（transactions）

欄位	類型	說明
transaction_id	string	成交紀錄唯一編號
estate	string | null	屋苑名稱（非屋苑大廈為 null）
phase	string | null	期數/分期名稱
building	string | null	座數/大廈名稱
address	string | null	街道地址
district	string | null	地區
floor	string | null	樓層描述，如 高層
unit	string | null	單位，如 E室
deal_type	string | null	sale（買賣）或 rent（租賃）
price	number | null	成交價／租金（港幣）
currency	string	固定 HKD
gross_area_sqft	number | null	建築面積（平方呎）
net_area_sqft	number | null	實用面積（平方呎）
gross_unit_price	number | null	建築呎價
net_unit_price	number | null	實用呎價
bedrooms	number | null	房間數
first_or_second_hand	string | null	一手／二手
built_year	number | null	落成年份
data_source	string | null	資料來源（如土地註冊處）
transaction_date	string | null	成交日期（YYYY-MM-DD，原始資料無時分秒，不捏造時間）
detail_url	string | null	成交詳情連結
source_mode	string	固定 transactions
source_query	string	搜尋的屋苑關鍵字
scraped_at	string	抓取時間（ISO 8601）

輸出欄位（ccl）

欄位	類型	說明
series	string	ccl（大盤）/ hk（港島）/ kln（九龍）/ nte（新界東）/ ntw（新界西）/ big（大型單位）/ normal（中小型單位）/ estate（大型屋苑）
series_name	string	系列中文名稱，如「中原城市領先指數 CCL」「港島」
week_ending	string	當週日期（YYYY-MM-DD）
index	number	指數值
change_pct_wow	number | null	週變幅（%），歷史最早一筆為 null
change_pct_mom	number | null	月變幅（%），只有最新一筆有值
publish_date	string | null	官方公佈時間（ISO 8601），只有最新一筆有值
source_mode	string	固定 ccl
scraped_at	string	抓取時間（ISO 8601）

series=ccl（大盤）會回傳一段週序列（依 weeks 決定筆數）；其餘七個子指數只回傳最新一筆。

---

模式

mode	說明	輸入	計費
search	關鍵字搜尋，同時查詢中原及 28Hse（可選擇單一來源）	keywords[] + dealType	$0.002 / 筆
detail	中原樓盤完整詳情（需要物業編號）	propertyIds[] 或 propertyUrls[]	$0.008 / 筆
transactions	中原成交紀錄，依屋苑名抓歷史成交（買賣及租賃）	keywords[]（屋苑名）+ dealType	$0.002 / 筆
ccl	中原城市領先指數（CCL）週序列，含港島/九龍/新界東/新界西/大型/中小型/大型屋苑七個子指數	weeks（選填，預設 52）	$0.002 / 筆

---

輸入參數

參數	類型	預設	說明
mode	string	自動偵測	search、detail、transactions 或 ccl
keywords	string[]	—	搜尋關鍵字，如 ["太古城", "九龍城"]
dealType	string	buy	buy（買盤）或 rent（租盤）
source	string	both	centanet、28hse 或 both
propertyIds	string[]	—	中原物業編號，如 ["CLL467", "DAJ422"]
propertyUrls	string[]	—	中原物業詳情頁網址
bulkInput	string	—	一行一個關鍵字或 ID，自動合併
priceMin	number	—	最低價格（港幣）
priceMax	number	—	最高價格（港幣）
areaMin	number	—	最小面積（實用平方呎）
dateFrom	string	—	只保留這個日期之後的成交（僅 transactions 模式）。相對時間 3d／12h／2w，或絕對日期 MM/DD/YY
weeks	number	52	CCL 指數抓最近幾週（僅 ccl 模式）。0 = 1994 年起全部歷史
maxItems	number	50	最多筆數（上限 2000）。transactions 模式為每個屋苑關鍵字各自上限

---

使用範例

範例 1：太古城買盤搜尋（兩站合併）

{
    "mode": "search",
    "keywords": ["太古城"],
    "dealType": "buy",
    "source": "both",
    "maxItems": 50
}

範例 2：九龍城租盤搜尋（只抓中原）

{
    "mode": "search",
    "keywords": ["九龍城", "馬頭圍"],
    "dealType": "rent",
    "source": "centanet",
    "priceMin": 15000,
    "priceMax": 30000,
    "maxItems": 100
}

範例 3：按物業編號抓詳情

{
    "mode": "detail",
    "propertyIds": ["CLL467", "DAJ422", "DAR140"],
    "maxItems": 100
}

範例 4：太古城成交紀錄（買盤，100 筆）

{
    "mode": "transactions",
    "keywords": ["太古城"],
    "dealType": "buy",
    "maxItems": 100
}

範例 5：CCL 指數（最近 104 週，約 2 年）

{
    "mode": "ccl",
    "weeks": 104
}

---

樓價指數與成交監控

transactions 與 ccl 模式適合排程定期執行，把每次抓到的資料疊起來就是一條時間序列：

• 屋苑成交價監控：對同一個 keywords（屋苑名）+ dealType 定期跑 transactions，用 dateFrom 只抓上次執行之後的新成交（例如每天排程、dateFrom: "1d"），dataset 疊加起來就是該屋苑的成交價曲線。
• CCL 走勢追蹤：ccl 模式每次都回傳最新一段週序列（weeks 決定回溯幾週），適合每週排程一次（例如週五 CCL 公佈後執行），用 week_ending／publish_date 對齊追蹤大盤及七個子指數的變化。

在 Apify Console 用 Schedule 設定 cron（如 0 20 * * 5 = 每週五晚上 8 點）即可自動化，不需要自己寫排程邏輯。

---

注意事項

• 只抓取公開資料，無需登入或帳號
• 中原地產及 28Hse 的公開 API 端點均以 POST 形式呼叫（ccl 模式例外，是單純 GET 網頁）
• 因 Crawlee 爬蟲排程關係，同一搜尋字可能出現跨頁去重（property_id 或 transaction_id 層級）
• search 模式抓取兩站資料，property_id 格式不同（中原為英數字組合如 CLL467，28Hse 為純數字）
• detail、transactions、ccl 三種模式僅支援中原地產（28Hse 無公開詳情/成交/指數 API）
• transactions 模式的成交紀錄依觀察為新到舊排序，但官方 API 未明文保證此順序，dateFrom 提早停止邏輯以此為基礎
• 每次 Run 固定扣除 $0.005 啟動費，再依實際抓取筆數計費

---

FAQ

Q：可以同時搜尋買盤和租盤嗎？ A：目前每次 Run 只能選一種 dealType。如需兩者，請分開執行兩次。

Q：搜尋結果數量為什麼比預期少？ A：maxItems 上限為 2000。若搜尋關鍵字太廣，系統會在連續 5 頁無新資料後自動停止，節省費用（transactions 模式如遇到單頁完全沒新資料則直接停止，不會重試）。

Q：detail 模式怎麼取得物業編號？ A：從中原地產網站物業頁面 URL 擷取（格式如 CLL467），或先用 search 模式取得 property_id 欄位後再使用 bulkInput 貼入。

Q：28Hse 有沒有呎價資料？ A：有，price_per_sqft 欄位對 28Hse 搜尋結果同樣有效（實用呎價）。

Q：成交紀錄跟樓盤搜尋有什麼不同？ A：search 模式抓的是「目前在放售/放租的樓盤」；transactions 模式抓的是「已經完成、實際成交的歷史紀錄」（成交價、成交日期），兩者是不同資料源，無法互相取代。想追蹤某屋苑的真實成交價走勢，要用 transactions 模式。

---

📚 延伸教學與工具

這隻 actor 背後的實戰教學與免費工具，都在 AI Social API：

• 📖 教學：CCL指數話全年樓價升12%，沙田第一城照樣蝕100萬沽——大盤指數同你想買嗰個屋苑係兩回事
• 📊 原創資料：站台涵蓋表：模式、欄位與定價 — 40 個站台各有哪些模式、實際回傳哪些欄位、每筆多少錢，全部從 actor 自己的 schema 生成
• 🛠 免費工具：香港樓價查詢 · Apify 成本試算
• 🤝 不想自己跑？我幫你每天跑——排程好每天送進你的 Google Sheet 或 Slack，每月 US$299 起。

由實際經營 40+ 隻上架 actor 的人維護。

---

免責聲明

本 Actor 僅抓取各網站公開頁面資料，用於研究、分析及資料整合用途。使用者須遵守中原地產及 28Hse 的服務條款。資料準確性以原始網站為準，本 Actor 不對任何投資決策負責。

---

中原地產 爬蟲、28Hse 爬蟲、香港樓盤、CCL 中原城市指數、香港房價、物業數據、HK property scraper、Centaline scraper、成交紀錄、CCL 指數