按房源 ID 查询英国住宅出售详情

查看 Rightmove 英国房产搜索与成交价查询 的全部接口 →

通过必填的字符串查询参数 id 获取一套待售住宅的详情。文档指定该标识来自 property-for-sale 接口;应将搜索结果中的房源 ID 保留为字符串,并在接入时验证搜索结果与详情查询之间的 ID 对应关系。文档中的截断示例以 data 对象开头,可见详情字段包括 address.countryCode、address.displayAddress、address.incode、address.outcode 和 address.ukCountry,以及 bedrooms、bathrooms、affordableBuyingScheme、businessForSale、channel 和 commercial。示例还展示了 broadband.broadbandCheckerUrl 与 broadband.disclaimer、brochures 数组、commercialUseClasses 数组、contactInfo.contactMethod 与 contactInfo.telephoneNumbers,以及 customer 中的 branchDisplayName、branchId、branchName、companyName、companyTradingName、isNewHomeDeveloper 和 developmentInfo 等字段。示例中的 address.deliveryPointId、auctionProvider 和 countryGuide 为 null,brochures 与 commercialUseClasses 为空数组,但这不代表相关信息始终不存在。这些字段来自未经验证且不完整的文档示例,并非本接口的实测响应。本接口未提供实际请求的响应记录,完整详情结构、更新时间及 ID 不存在时的行为均尚未验证。

API 功能

按选定房源 ID 获取出售详情 使用必填查询参数 id 请求单套待售房源的详情,无需重新提交整组房源搜索条件。
参考结构化出售房源地址 文档示例的 data.address 包含 displayAddress、incode、outcode、countryCode 和 ukCountry;该示例中的 deliveryPointId 为 null。
补充房间数量与住宅属性 文档示例列出了 bedrooms、bathrooms、affordableBuyingScheme,以及 businessForSale、channel 和 commercial 字段;字段覆盖情况尚未验证。
展示宽带查询参考与免责声明 可见的 broadband 对象包含 broadbandCheckerUrl 和 disclaimer,应将其作为文档列出的参考信息,而非实测连接速度。
呈现经纪门店及开发商背景 示例中的 customer 包含门店与公司名称、isNewHomeDeveloper 和 developmentInfo,可用于丰富选定房源的详情视图。
区分详情缺失与空值状态 展示出售房源时分别处理字段缺失、null 和空数组;不完整的示例并不能证明响应具有固定且完整的结构。

在线 API 演示

GET /api/project/rightmove/property-for-sale-detail

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/rightmove/property-for-sale-detail?key=<API_KEY>&id=<id>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

出售房源详情所需的 id 从哪里获取?

文档指定使用 property-for-sale 接口返回的 id,通过必填的字符串查询参数 id 传入;文档中的占位示例为 126451514。正式依赖此流程前,应验证所选搜索记录的 ID 能否正确对应详情查询。

文档展示了怎样的详情响应结构?

提供的文档示例以 data 对象开头,其中包含 address 对象、卧室和浴室数量、住宅属性标记、宽带参考信息、contactInfo 和 customer 详情。该示例已被截断,且未通过本接口的实际请求验证,因此不属于经过验证的完整响应约定。

宽带字段是否提供经过验证的连接速度?

不是。可见的 broadband 对象包含 broadbandCheckerUrl 和 disclaimer。现有资料没有列出实测网速字段,也不能据此确认某套房产的宽带可用性。

字段为 null 或 brochures 为空,是否代表房产没有相应信息?

不一定。示例中的 auctionProvider、countryGuide 等字段为 null,brochures 等数组为空。应将这些状态保留为未知或未提供;单个示例不能证明房产不具备相关特征,也不能证明信息会一直缺失。

详情请求成功,能否证明房源信息最新且仍在出售?

不能。文档未提供更新时效或在售状态保证,本接口也未提供实测响应。请记录自己的数据获取时间,不要将返回的详情记录视为房源当前仍可购买的证明。

应用应如何处理未知或已下架的房源 ID?

现有文档未说明 ID 不存在或房源下架时的行为。应为请求失败和详情数据缺失做好容错处理,不要预设特定错误码,也不要直接套用其他接口的行为。

相关接口

相关指南

查看订阅方案 →