按地点及购房偏好搜索英国在售新房
查看 Rightmove 英国房产搜索与成交价查询 的全部接口 →使用必填的 identifier 地点标识,搜索在售新房集合。参数文档指向 auto-complete 所选 data 条目中的 locationIdentifier,示例为 REGION^1036。可选参数包括数值类型的价格和卧室数量上下限、数值类型的 page、字符串类型的 search_radius、逗号分隔的 keywords 和 property_type,以及 added_to_site、sort_by;还可通过布尔标志设置花园、停车位、拍卖房源、购房计划、养老住宅,以及是否包含已收到报价或已接受报价但待签约(Sold STC)的房源。文档未说明 added_to_site 和 sort_by 的允许值、页码起点或标志之间的优先级。本接口未纳入已观测的测试。尚未验证且不完整的响应示例以 currentPage 和 data 数组开头,可见的房源字段包括 id、displayAddress、bedrooms、bathrooms、addedOrReduced、auction、channel、price.amount、price.currencyCode、price.displayPrices、location.latitude、location.longitude、listingUpdate 和 propertyImages.images。这些只是示例字段,并非经过验证的完整结构。不得套用其他搜索接口的分页总数、数据时效保证或响应字段要求。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/rightmove/new-homes-for-sale API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/rightmove/new-homes-for-sale?key=<API_KEY>&identifier=<identifier>'
查询结果
使用场景
- 构建新建住宅专属找房页,让买方将选定地点与预算、卧室数量及住宅类型条件组合使用。
- 根据家庭购房者所需的卧室区间,结合花园和停车位偏好建立候选新房清单。
- 确认 added_to_site 支持的值后建立新房研究队列,并与二手房监测流程分开维护。
- 让买方分别审阅购房计划和养老住宅的筛选偏好,在行为尚未验证时避免启用相互冲突的标志。
- 仅使用文档列出的搜索半径选项对比新房搜索范围,不自行添加距离值或假定距离单位。
常见问题
必填的 identifier 从哪里获取?
参数文档指向 auto-complete 所选 data 条目中的 locationIdentifier,文档示例为 REGION^1036。应先检查选中的地点建议并验证其标识,再用于新房搜索。
住宅类型和关键词应该如何传入?
两者都是可选的逗号分隔字符串。文档列出的住宅类型为 Detached、SemiDetached、Terraced、Flat、Bungalow、Land 和 ParkHome,组合示例为 Detached,SemiDetached。关键词的文档示例为 pool, garden。
search_radius 支持哪些文档值?
文档列出的字符串值为 0.0、0.25、0.5、1.0、3.0、5.0、10.0、15.0、20.0、30.0 和 40.0。所提供的参数文档没有说明距离单位,因此不要自行假定或标注单位。
页码起点、排序方式和上架时间筛选值有明确规定吗?
page 为可选数值参数,sort_by 和 added_to_site 为可选字符串参数。文档未说明页码起点,也未列出这两个字符串参数的允许值。除非已经验证应用需要的值,否则应保持不传。
购房计划和养老住宅标志可以任意组合吗?
购房计划和养老住宅分别提供偏向纳入与排除的独立标志,但文档没有说明默认值和优先级。应避免冲突组合,并在将组合保存为搜索设置前,验证其实际行为。
本次新房搜索响应有哪些字段经过验证?
本接口未纳入已观测的测试。不完整的响应示例展示了 currentPage 和 data 数组,数组中可见房源标识、地址、卧室与浴室数量、价格、坐标、更新信息及图片结构。应将它们视为尚未验证的示例字段,而不是完整或保证返回的响应结构。