查询所选在售新房的单套房源详情
查看 Rightmove 英国房产搜索与成交价查询 的全部接口 →通过必填的 id 查询字符串,读取一条在售新房记录。文档要求使用 new-homes-for-sale 返回的房源 id,示例为 129254912;这是房源标识,不是区域搜索所用的地点标识。本详情接口没有文档列出的搜索筛选参数,也未纳入已观测的测试。尚未验证且不完整的响应示例展示了 data 对象,其中包含 address 地址对象、bedrooms、可为 null 的 bathrooms、affordableBuyingScheme、channel、contactInfo 和 customer 对象。可见的地址字段包括 displayAddress、countryCode、incode、outcode 和 ukCountry;可见的 customer 字段包括 branchDisplayName、branchId、branchName、companyName、companyTradingName、developmentInfo 和 isNewHomeDeveloper,其中 developmentInfo 包含 sitePlanUri 与 micrositeFeatures。这些只是示例中可见的属性,既不是经验证的完整结构,也不保证每条记录都包含这些属性。渲染详情页前应检查实际返回结构,不得据此推断当前可售状态或完整楼盘房源清单,也不得从其他接口套用本接口未说明的价格和图片字段。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/rightmove/new-homes-for-sale-detail API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/rightmove/new-homes-for-sale-detail?key=<API_KEY>&id=<id>'
查询结果
使用场景
- 仅在买方选中一条新房搜索结果后打开对比抽屉,按需请求该房源详情,而不是逐条加载全部结果。
- 制作购房研究资料前,重新读取候选清单中的一套新房记录,保留请求 ID 和获取时间,但不据此声称房源仍可购买。
- 用地址和卧室信息制作详情卡片原型,并为示例中可为 null 的 bathrooms 字段提供暂无数据的展示状态。
- 先审阅选中房源实际返回的门店和开发商信息,再决定是否展示楼盘补充信息区域。
常见问题
id 参数应该从哪里获取?
使用 new-homes-for-sale 返回的房源 id。文档示例为 129254912,应以字符串传入。它不是 REGION^1036 这类由 auto-complete 返回的地点标识。
详情请求中可以按地点、价格或卧室数量筛选吗?
此处没有文档列出的此类筛选参数,本接口只有必填的 id 查询参数。应先在 new-homes-for-sale 中设置地点及购房偏好,再按 ID 请求选中的房源详情。
示例包含哪些地址和房间信息?
未经验证的示例展示了 data.address 中的 displayAddress、countryCode、incode、outcode 和 ukCountry,同时展示了 bedrooms 以及值为 null 的 bathrooms。示例并不完整,也不能据此认定每次响应都包含这些字段。
示例中有开发商信息吗?
示例的 customer 对象包含门店和公司字段、isNewHomeDeveloper 及 developmentInfo。可见的 developmentInfo 字段包括 sitePlanUri 和 micrositeFeatures。用于详情布局前,应验证这些字段是否实际存在及其具体值。
本接口的响应在已观测测试中经过验证了吗?
没有。所提供的证据中没有本接口的测试调用记录,其响应说明仅依据一份不完整且未经验证的示例。其他接口测试成功,并不代表本详情接口的响应已经得到验证。
详情记录能证明房源仍在售,或代表整个楼盘的信息吗?
文档未保证当前可售状态,也未保证覆盖完整楼盘。应将其视为针对一条选中房源的查询,研究时保留获取记录的上下文,并对时效敏感的结论另行核实。