我可以擷取哪些資料?
已發佈的物件,包含參考文件中說明的所有物件資訊;Advanced 等級的彙總 Insights 即將推出。任何情況下都不會回傳刊登者、房仲、屋主或諮詢資料。
GET /v1/properties 會針對您的金鑰所涵蓋的某個國家,回傳一頁已發佈的物件。每筆物件包含下列欄位:
- 基本資訊欄位:物件編號 id、所在國家 country、刊登類型 listing_type 與物件類型 property_type
- 地址與行政區欄位:省份名稱 province 與省份識別碼 province_id,城市名稱 city 與城市識別碼 city_id,區域名稱 area 與區域識別碼 area_id,街道地址 address,以及郵遞區號 post_code
- 地理座標欄位:緯度 latitude、經度 longitude 與位置精確程度 location_precision
- 價格 price、最高價格 price_max 與幣別 currency
- 臥室數 bedrooms、浴室數 bathrooms 與房間數 rooms
- 面積相關欄位:室內面積 living_area,以及以平方公尺為單位的室內面積 living_area_sqm;土地面積 lot_area,以及以平方公尺為單位的土地面積 lot_area_sqm
- 年份與日期欄位:建成年份 build_year、物件發佈日期 published_date 與物件最後更新時間 last_updated
- 描述性欄位:物件特色 features、配備家電 appliances、周邊環境 neighbourhood 與標籤 tags
- 建商資訊 developer、物件摘要 summary、物件說明 description 與位置文字說明 location_text
- 圖片 images
說明為純文字,其中的聯絡資訊已被移除。由屋主自行刊登的房屋,回傳的位置會經過模糊處理,且不含門牌號碼;location_precision 會標示每個位置的精確程度。物件目前不含圖片:在新增圖片連結之前,images 欄位為空清單。
在任何等級下,任何端點都不會回傳刊登者、房仲、屋主或諮詢資料。欄位名稱在所有語言中完全相同,參考文件列出了每個欄位的型別。

