查询所选在售新房的单套房源详情

查看 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 功能

按房源编号读取单套新房 使用从 new-homes-for-sale 获取的必填字符串 id 读取选中记录,而非再次执行区域搜索。
详情地址结构映射 未经验证的示例在 data.address 中展示了 displayAddress 和邮编组成字段,可作为候选结构,在验证后再用于页面渲染。
兼容浴室数量缺失 示例包含 bedrooms,且 bathrooms 值为 null;详情布局应允许浴室数据不可用,不应自行补出数量。
开发商与门店背景查看 查看示例 customer 中的门店及公司字段,包括 isNewHomeDeveloper,同时注意这些字段在其他记录中是否出现尚未验证。
楼盘补充信息检查 示例中的 customer.developmentInfo 包含 sitePlanUri 和 micrositeFeatures;设计楼盘专属组件前应核实实际返回值。

在线 API 演示

GET /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 参数应该从哪里获取?

使用 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。用于详情布局前,应验证这些字段是否实际存在及其具体值。

本接口的响应在已观测测试中经过验证了吗?

没有。所提供的证据中没有本接口的测试调用记录,其响应说明仅依据一份不完整且未经验证的示例。其他接口测试成功,并不代表本详情接口的响应已经得到验证。

详情记录能证明房源仍在售,或代表整个楼盘的信息吗?

文档未保证当前可售状态,也未保证覆盖完整楼盘。应将其视为针对一条选中房源的查询,研究时保留获取记录的上下文,并对时效敏感的结论另行核实。

相关接口

相关指南

查看订阅方案 →