按地区与购房条件搜索英国住宅出售房源

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

搜索英国待售住宅,必填的 identifier 应使用地区自动补全结果 data[].locationIdentifier 中的地区标识。可选条件包括最低与最高价格、最少与最多卧室数、以英文逗号分隔的房产类型及关键词、搜索半径、房源发布时长、页码和排序。布尔参数可用于请求筛选花园、停车位、拍卖房、购房计划、新房及退休住宅,纳入已接受报价(under offer)或已达成交易意向但仍待合同确认(sold STC)的房源,或排除指定住宅类别。文档未说明同时使用纳入与排除参数时的优先级。文档中的截断示例展示了 currentPage 和 data 数组;可见房源字段包括 id、displayAddress、bedrooms、bathrooms、propertySubType、propertyTypeFullDescription、propertyUrl、addedOrReduced、firstVisibleDate、auction、location.latitude 和 location.longitude。其中 price 对象包含 amount、currencyCode、displayPrices 和 frequency;listingUpdate 包含 listingUpdateDate 和 listingUpdateReason;propertyImages 包含 images、mainImageSrc 和 mainMapImageSrc。这些仅为未经验证的示例字段,并非本接口的实测响应,也不保证每条房源均包含这些字段。本接口未提供实际请求的响应记录,结果覆盖范围、筛选效果及房源更新时效均尚未验证。

API 功能

以地区标识组织购房搜索 将自动补全返回的 locationIdentifier 作为 identifier 传入,并在保存购房条件时一并保留该地区标识。
分别设置价格与卧室数上下限 使用独立的最低和最高价格、最少和最多卧室数参数表达购房需求,保持各参数原有的数据类型。
用逗号组合待售房产类型 通过 property_type 指定 Detached、SemiDetached、Flat、Bungalow 等文档列出的类型,多个值以英文逗号分隔。
独立配置出售房源类别开关 分别设置拍卖房、购房计划、新房和退休住宅参数;参数名称表明其筛选意图,但组合使用时的具体行为尚未验证。
选择近期发布房源时间窗 added_to_site 支持文档列出的 1、3、7、14 四种发布时间窗,留空表示不限时间。
参考示例字段设计购房列表卡片 根据示例中的地址、卧室数、价格、坐标和图片字段规划展示,同时兼容字段缺失及覆盖范围尚未验证的情况。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

住宅出售搜索需要传入哪种地区值?

必填参数 identifier 应取自地区自动补全响应 data[] 中的 locationIdentifier,文档示例为 REGION^1036。这是地区标识,不是单套房源的 ID。

如何同时指定多个房产类型或关键词?

property_type 接受以英文逗号分隔的值,文档列出的类型为 Detached、SemiDetached、Terraced、Flat、Bungalow、Land 和 ParkHome。keywords 也使用英文逗号分隔,文档示例为 pool, garden;关键词的匹配与排序规则未作说明。

added_to_site 支持哪些值?

1 表示最近 24 小时,3 表示最近 3 天,7 表示最近 7 天,14 表示最近 14 天。留空表示不限时间,并保留现有的空值默认设置。

新房或购房计划的纳入与排除参数可以同时使用吗?

这些类别分别提供 has_* 和 do_not_show_* 参数,但文档未定义优先级,也未证明两类开关严格互补。应明确配置所需条件并检查返回结果,不要假设冲突参数会相互抵消。

响应中的出售房源字段经过实际验证了吗?

本接口未提供实测响应。文档中的截断示例展示了 currentPage,以及包含标识、地址、卧室和浴室数量、房产类型、价格、坐标及图片相关字段的 data 记录。这些只能作为字段示例参考,不能视为经过验证的完整结构或字段可用性保证。

页码起点、排序代码和搜索半径单位是否明确?

page 为可选数字参数,sort_by 为可选字符串参数,但文档未提供页码起点规则或排序取值。search_radius 列出了 0.0 至 40.0 范围内的若干字符串选项,但未说明单位。不要根据其他接口推断这些细节。

相关接口

相关指南

查看订阅方案 →