我可以获取哪些数据?
已发布的房源,包含参考文档中描述的全部房产信息;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 字段为空列表。
在任何级别下,任何端点都不会返回发布者、房产经纪人、业主或咨询数据。字段名称在所有语言中完全相同,参考文档列出了每个字段的类型。

