按地区与购房条件搜索英国住宅出售房源
查看 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 为购房需求建立可保存的搜索条件,将地区标识、价格区间、卧室数范围和房产类型与每份候选清单关联。
- 为买家提供花园与停车位筛选预设,并核对返回房源,不将筛选结果默认视为严格符合全部设施要求。
- 分别配置拍卖房、新房和退休住宅发现页面,不把纳入与排除开关视为严格互补。
- 让买家在已保存的地区内重新查询最近 24 小时、3 天、7 天或 14 天发布的房源,而不将结果描述为完整的房源变更记录。
- 利用文档示例中的坐标和价格字段制作地图式待售房源候选清单,并为缺失数据设置降级展示。
常见问题
住宅出售搜索需要传入哪种地区值?
必填参数 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 范围内的若干字符串选项,但未说明单位。不要根据其他接口推断这些细节。