按房源 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 与详情查询的对应关系。
- 准备看房候选清单前重新获取选定房源详情并记录获取时间,但不将该时间称为房源更新时间。
- 在文档列出的字段可用时,为已保存的购房记录补充邮编组成部分、卧室数和浴室数。
- 在单套待售房源详情页展示宽带参考链接及其免责声明,不将参考信息作为网速保证。
- 为选定的待售房源展示经纪门店或开发商背景,同时将空值和缺失属性保留为未知状态。
常见问题
出售房源详情所需的 id 从哪里获取?
文档指定使用 property-for-sale 接口返回的 id,通过必填的字符串查询参数 id 传入;文档中的占位示例为 126451514。正式依赖此流程前,应验证所选搜索记录的 ID 能否正确对应详情查询。
文档展示了怎样的详情响应结构?
提供的文档示例以 data 对象开头,其中包含 address 对象、卧室和浴室数量、住宅属性标记、宽带参考信息、contactInfo 和 customer 详情。该示例已被截断,且未通过本接口的实际请求验证,因此不属于经过验证的完整响应约定。
宽带字段是否提供经过验证的连接速度?
不是。可见的 broadband 对象包含 broadbandCheckerUrl 和 disclaimer。现有资料没有列出实测网速字段,也不能据此确认某套房产的宽带可用性。
字段为 null 或 brochures 为空,是否代表房产没有相应信息?
不一定。示例中的 auctionProvider、countryGuide 等字段为 null,brochures 等数组为空。应将这些状态保留为未知或未提供;单个示例不能证明房产不具备相关特征,也不能证明信息会一直缺失。
详情请求成功,能否证明房源信息最新且仍在出售?
不能。文档未提供更新时效或在售状态保证,本接口也未提供实测响应。请记录自己的数据获取时间,不要将返回的详情记录视为房源当前仍可购买的证明。
应用应如何处理未知或已下架的房源 ID?
现有文档未说明 ID 不存在或房源下架时的行为。应为请求失败和详情数据缺失做好容错处理,不要预设特定错误码,也不要直接套用其他接口的行为。