香港 Squarefoot 尋屋爬蟲（5平方）

抓香港 Squarefoot 尋屋（squarefoot.com.hk，中文站名「5平方」）的公開樓盤：放售與出租盤。不用登入、不用申請 API key、不開瀏覽器。

Squarefoot 屬 iProperty／REA 集團，是香港三語物業入口之一。Apify Store 上目前沒有其他人覆蓋這個站。

輸出欄位

欄位	型別	說明
property_id	string	Squarefoot 盤源編號
deal_type	string	buy（放售）或 rent（出租）
district	string|null	地區，例如 九龍塘 / Tai Po
estate	string|null	屋苑或大廈，例如 康樂園
unit_description	string|null	單位描述，例如 獨立屋 / Whole Block
price_hkd	number|null	售價或月租（港元，已換算）
price_text	string|null	價格原文，例如 售 $410 萬元／Sell HKD$19.6 Millions
unit_price_per_sqft	number|null	實用呎價（租盤為每呎月租）
saleable_area_sqft	number|null	實用面積（平方呎）
bedroom	number|null	房數（開放式單位為 0）
bathroom	number|null	廁所數
is_studio	boolean	是否為開放式單位
orientation	string|null	座向，例如 向東北 / South east
monthly_repayment_hkd	number|null	每月供款試算（僅買盤）
agent_remark	string|null	代理描述，例如 全新靚裝修
thumbnail_url	string|null	封面圖
photo_urls	string[]|null	全部相片網址
listing_url	string|null	盤源頁網址
posted_text	string|null	刊登時間原文，例如 11 小時前 刊登
posted_at	string|null	刊登時間（已換算成 ISO 8601 絕對時間）
scraped_at	string	抓取時間（ISO 8601）

欄位名一律英文 snake_case；缺值一律 null，不會省略欄位。

輸入

欄位	型別	預設	說明
mode	enum	search	目前只有樓盤列表
dealType	enum	buy	buy 放售、rent 出租
regions	string[]	全部	港島／九龍／新界／離島，留空＝四區全抓
bulkRegions	string	—	一行一個，與上面自動合併
language	enum	zh-hk	zh-hk 或 en
maxItems	integer	50	本次最多幾筆（每頁 10 筆），上限 500
proxyConfiguration	object	香港 residential	請保持預設，見注意事項

輸入範例

1. 九龍放售盤 100 筆

{ "mode": "search", "dealType": "buy", "regions": ["九龍"], "maxItems": 100 }

2. 港島出租盤

{ "mode": "search", "dealType": "rent", "regions": ["港島"], "maxItems": 50 }

3. 離島放售盤，英文輸出

{ "mode": "search", "dealType": "buy", "regions": ["離島"], "language": "en", "maxItems": 50 }

4. 全港放售盤（四區合抓）

{ "mode": "search", "dealType": "buy", "maxItems": 500 }

5. 大量貼上地區

{ "mode": "search", "dealType": "buy", "bulkRegions": "港島\n九龍\n離島", "maxItems": 200 }

注意事項

• 請保持 proxy 預設（香港 residential）。 Squarefoot 用 Cloudflare 擋非住宅出口，而且住宅代理還必須指定香港 —— 實測未指定國家時即使走 residential 也一律 403。關掉 proxy、改 datacenter、或不指定香港，都會直接抓到 0 筆。頁面有 gzip 壓縮，每筆線路流量僅約 7KB，成本可忽略。
• Squarefoot 把香港分成四區，含「離島」 —— 這跟中原／美聯的三區、利嘉閣的「新界東／新界西」都不同。跨代理比對時要注意分區定義不一致。
• 可用的篩選只有地區。 站方列表頁沒有價格、面積或關鍵字的查詢參數，本 Actor 因此不假裝支援；要按這些條件過濾，請拿到資料後自行篩選。
• maxItems 是所有地區合計的上限，不是每區。每頁固定 10 筆。
• 刊登時間已換算成絕對時間。 站方只給「11 小時前」這種相對時間，本 Actor 轉成 ISO 8601 寫進 posted_at，原文保留在 posted_text。
• 開放式單位的 bedroom 是 0（不是 null），並以 is_studio: true 標示。
• 價格已換算：售 $410 萬元 → 4100000、Sell HKD$19.6 Millions → 19600000。原文保留在 price_text。
• 抓取期間若有新盤上架，分頁會位移而出現重複；本 Actor 全 run 去重，同一筆只輸出並計費一次。
• 只抓公開資料，不登入、不繞過任何驗證。

計費

單一事件 search-listing，每輸出一筆 $0.002。只有成功寫進 dataset 的資料才計費；重複與被過濾掉的不收費。

FAQ

Q：可以只抓某個屋苑或價格範圍嗎？ A：站方列表頁沒有這些查詢參數。做法是抓該區後依 estate、price_hkd 欄位自行過濾。

Q：price_hkd 對租盤是什麼？ A：月租金。unit_price_per_sqft 則是每呎月租（數字會小很多，例如 64.9）。

Q：為什麼一定要香港的住宅代理？ A：Cloudflare 對非住宅出口一律 403，而且只認香港住宅 IP。這是站方的設定，不是本 Actor 的限制。好消息是頁面有壓縮，每筆線路流量約 7KB，成本極低。

Q：可以跟中原、美聯、利嘉閣的資料合併比較嗎？ A：可以。都輸出 snake_case、實用面積與實用呎價，適合做代理間的庫存與定價比較。注意四家的分區定義都不一樣（Squarefoot 有離島、利嘉閣分新界東西、中原美聯是三區），建議用屋苑名做模糊比對而不是靠分區欄位。

Q：抓到的筆數比 maxItems 少？ A：代表該區的資料已抓完。可改抓其他區或放寬條件。

免責聲明

本 Actor 僅用於個人研究、學術分析、市場調查、房產趨勢研究等合法用途。使用時請遵守 Squarefoot（squarefoot.com.hk）服務條款及香港相關法規。請勿大量爬取、勿商業轉售原始資料。作者不對任何因使用本工具造成的損害承擔責任。

---

香港樓盤爬蟲 Squarefoot 爬蟲 5平方 尋屋 香港房產資料 HK property data 放售樓盤 出租樓盤 實用呎價 屋苑資料 香港地產 property listings Hong Kong real estate 樓盤匯出 物業數據 離島樓盤

---

📚 延伸教學與工具

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

• 📊 原創資料：站台涵蓋表：模式、欄位與定價 — 40 個站台各有哪些模式、實際回傳哪些欄位、每筆多少錢，全部從 actor 自己的 schema 生成
• 🛠 免費工具：香港樓價查詢 · Apify 成本試算
• 🤝 不想自己跑？我幫你每天跑——排程好每天送進你的 Google Sheet 或 Slack，每月 US$299 起。

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