按地点及购房偏好搜索英国在售新房

查看 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 功能

独立的新建住宅搜索 通过地点标识查询在售新房,将新房浏览流程与一般二手房搜索区分开来。
购房预算与卧室区间组合 结合 min_price、max_price、min_bedroom 和 max_bedroom,表达本接口支持的买方价格及卧室数量区间。
按文档选取住宅形态 property_type 支持一个或多个逗号分隔的类型,例如 Detached、SemiDetached 或 Flat;传入值应使用文档列出的拼写。
新房花园与停车位偏好 将 has_garden 和 has_parking 布尔参数作为可选找房偏好展示,不为它们指定文档未说明的默认值。
新房类别与交易状态控制 分别呈现购房计划、养老住宅、拍卖房源,以及已收到报价或 Sold STC 房源的相关标志,并明确其组合规则尚未说明。
新房区域半径与关键词细化 使用文档列出的 search_radius 值及 pool, garden 等逗号分隔关键词,进一步细化选定区域的新房搜索。

在线 API 演示

GET /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>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

必填的 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 数组,数组中可见房源标识、地址、卧室与浴室数量、价格、坐标、更新信息及图片结构。应将它们视为尚未验证的示例字段,而不是完整或保证返回的响应结构。

相关接口

相关指南

查看订阅方案 →