用公开地点示例开始商业地产搜索
将 <API_KEY> 替换为你获授权使用的本平台 API 密钥。请求地址会包含密钥,请勿将它放入共享链接、截图或日志。
示例使用商业地产出租搜索,地点 identifier 为 REGION^274,page 为 1,search_radius 为 0.0。可先保留这组公开参数,再改为地点自动补全返回的目标地区标识;示例不保证始终有匹配房源。
基础 URL https://api.opendata-api.com
curl -X GET 'https://api.opendata-api.com/api/project/rightmove/commercial-property-to-rent?key=<API_KEY>&identifier=REGION%5E274&page=1&search_radius=0.0'import requests
response = requests.request(
"GET",
"https://api.opendata-api.com/api/project/rightmove/commercial-property-to-rent",
params={
"key": "<API_KEY>",
"identifier": "REGION^274",
"page": "1",
"search_radius": "0.0",
},
timeout=30,
)
response.raise_for_status()
print(response.json())const url = new URL("https://api.opendata-api.com/api/project/rightmove/commercial-property-to-rent");
url.search = new URLSearchParams({
"key": "<API_KEY>",
"identifier": "REGION^274",
"page": "1",
"search_radius": "0.0",
}).toString();
const response = await fetch(url, {
method: "GET",
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());发起房产查询前
- 普通房源搜索使用地点建议返回的完整 locationIdentifier,例如 REGION^1036,不能用城市名称代替。成交价搜索则把其专用地点建议返回的 locationIdentifier 与 type 分别填入 identifier 和 type,不要直接套用普通房源的组合标识。
- 住宅、新房、商业、普通租房和学生住宿各有对应详情接口,请传入同类搜索结果中的 id。相似房源详情使用相似搜索结果的 id;历史成交记录详情使用 uuid,不要假定这些标识可以跨接口互换。
- 比较商业出租报价前,先核对 price_type 的计价口径。面积区间 min_size、max_size 应与 size_unit 一起设置;平方英尺、平方米、英亩和公顷不能直接混算,接口未声明自动换算。
- 商业搜索结果中的 currentPage、resultsPerPage 和 totalResultCount 可用于核对分页;成交价搜索应读取其 meta,不能套用商业接口的分页字段。翻页时保持筛选条件一致,保存当前进度;页码重复、结果为空或总数变化时先复核,不能据此宣称已覆盖整个市场。
- 出售与出租搜索中的预算和报价属于挂牌口径,历史成交价来自独立查询。两者的时间、地区与房产范围可能不同,不应直接混算为市场涨跌,也不能假定挂牌房源与成交记录可以逐套对应或据此自动估值。
查看状态与返回数据
HTTP 状态表示请求在 HTTP 层的处理结果,还需检查响应体中网关的 code、message 和 data,不能只凭 HTTP 200 判断业务成功。确认业务状态后,再按当前接口解析结果;空列表也可能是正常的无匹配结果。
先选房源类别与查询目标
- 查找搜索地区标识
-
输入地点名称或关键词,按用途选择普通房源或成交价专用的地点建议。保留返回的地区标识;成交价搜索还需要与该标识对应的地点类型。
- 筛选待售住宅与新房
-
先取得普通地点建议返回的完整 identifier,再选择住宅出售或新房搜索,设置预算、卧室数量等条件。查看详情时,使用对应搜索结果中的房源 id。
- 从已选房源发现相似选择
-
先从住宅出售或新房搜索结果中取得房源 id,再查询相似房源。深入查看某个相似结果时,应传入该相似结果自己的 id,而不是沿用起始房源的 id。
- 寻找出租或出售的商业物业
-
使用普通地点建议返回的完整 identifier,分别搜索商业出租或出售物业。按需设置价格与面积,出租时核对计价口径,详情查询使用对应商业搜索结果的 id。
- 研究地区历史成交价
-
先从成交价专用地点建议取得匹配的地区标识与 type,再查询成交记录。若结果返回 uuid,可用它查询历史房产详情;不要用挂牌房源 id 替代。
- 按居住需求寻找租房
-
准备完整地点 identifier,使用住宅租赁搜索设置租金、卧室数量、家具配置和搜索半径等条件,再把所选租赁结果的 id 传给住宅租赁详情接口。
- 筛选学生住宿房源
-
从普通地点建议取得 identifier 后,使用学生住宿搜索设置预算、卧室数量和家具配置等条件,并以该类结果的 id 查看详情。地点标识并非大学名称,搜索半径也不等于已核实的到校距离。
地点查询
/api/project/rightmove/auto-complete 补全英国房产搜索地点,获取候选区域
完整文档 →说明
通过必填的 location 查询参数,按输入的地点词或短语获取候选地点。文档示例为 ch,已观测到的成功测试使用 London。该次 JSON 响应包含 status=true、字符串类型的 message,以及由地点候选对象组成的 data 数组。文档列出的候选字段包括展示名称 displayName、地点标识 locationIdentifier 和规范化搜索文本 normalisedSearchTerm;这些字段在出现时均为字符串。响应没有被声明为必返的字段。测试确认的是响应外层结构及当次已出现字段的类型,并不代表每条候选地点都始终包含全部字段。将选中地点的标识用于后续搜索前,应先核对目标接口对标识的要求;仅凭本接口不能确认标识可跨接口通用。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
新房出售
/api/project/rightmove/new-homes-for-sale 按地点及购房偏好搜索英国在售新房
完整文档 →说明
使用必填的 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。这些只是示例字段,并非经过验证的完整结构。不得套用其他搜索接口的分页总数、数据时效保证或响应字段要求。
调整条件并手动测试 必填 1 项 · 可选 18 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
展开更多筛选条件 (14)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/rightmove/new-homes-for-sale-detail 查询所选在售新房的单套房源详情
完整文档 →说明
通过必填的 id 查询字符串,读取一条在售新房记录。文档要求使用 new-homes-for-sale 返回的房源 id,示例为 129254912;这是房源标识,不是区域搜索所用的地点标识。本详情接口没有文档列出的搜索筛选参数,也未纳入已观测的测试。尚未验证且不完整的响应示例展示了 data 对象,其中包含 address 地址对象、bedrooms、可为 null 的 bathrooms、affordableBuyingScheme、channel、contactInfo 和 customer 对象。可见的地址字段包括 displayAddress、countryCode、incode、outcode 和 ukCountry;可见的 customer 字段包括 branchDisplayName、branchId、branchName、companyName、companyTradingName、developmentInfo 和 isNewHomeDeveloper,其中 developmentInfo 包含 sitePlanUri 与 micrositeFeatures。这些只是示例中可见的属性,既不是经验证的完整结构,也不保证每条记录都包含这些属性。渲染详情页前应检查实际返回结构,不得据此推断当前可售状态或完整楼盘房源清单,也不得从其他接口套用本接口未说明的价格和图片字段。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
住宅出售
/api/project/rightmove/property-for-sale 按地区与购房条件搜索英国住宅出售房源
完整文档 →说明
搜索英国待售住宅,必填的 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。这些仅为未经验证的示例字段,并非本接口的实测响应,也不保证每条房源均包含这些字段。本接口未提供实际请求的响应记录,结果覆盖范围、筛选效果及房源更新时效均尚未验证。
调整条件并手动测试 必填 1 项 · 可选 20 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
展开更多筛选条件 (16)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/rightmove/property-for-sale-detail 按房源 ID 查询英国住宅出售详情
完整文档 →说明
通过必填的字符串查询参数 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 不存在时的行为均尚未验证。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
/api/project/rightmove/similar-to-property 查找指定房源的相似备选房源
完整文档 →说明
通过必填的字符串查询参数 id 获取相似房源建议。文档将 property-for-sale/new-homes-for-sale 列为该房源 ID 的来源,并将 86104788 同时用作示例值和默认值。本接口未声明位置、价格、卧室数、半径、排序或分页参数。所提供的文档示例不完整,可见部分展示了 data 数组,其中包含 bathrooms、bedrooms、detailsUrl、displayAddress、displayPrice、displayPriceQualifier、hasFloorplan、hasVirtualTour、id 和 images 字段。示例中的房间数量为整数,id 和 displayPrice 为字符串,媒体存在标记为布尔值,displayPriceQualifier 为 null;图片对象包含 caption 和 url。这些字段仅来自未经实际请求验证的示例,不能视为已观测到的响应或完整且保证返回的字段结构。现有资料未提供本接口的实际请求响应,相似性判断依据、排序、结果数量以及不同房源接口之间的 ID 兼容性均未验证。请将结果仅作为备选房源,并独立核对是否符合需求;它们不保证满足先前搜索的预算或地域条件,也不是用于成交价估值的可比案例。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
/api/project/rightmove/similar-to-property-detail 查询所选相似房源的详情
完整文档 →说明
使用 similar-to-property 接口返回的房源标识符,通过必填的查询参数 id 获取所选备选房源的详情记录。应传入该备选房源本身的 ID,而不是地址,也不能假定其他搜索接口的标识符适用。未经验证的部分文档示例展示了一个 data 对象,包含 displayAddress、countryCode、incode 和 outcode 等地址字段、bedrooms、可为 null 的 bathrooms、commercial 与 businessForSale 标记、commercialUseClasses 和 brochures 数组,以及 branchDisplayName、companyName 等 customer 信息。这些只是文档中的示例字段,既不是独立验证的实际输出,也不是本接口完整且保证返回的字段结构。请将缺失值或 null 与已确认的房源属性明确区分。本接口用于补充已选备选房源的信息,不会生成相似房源列表,也不验证房源是否仍可售或可租,更不能据此确定估值。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
商业地产出租
/api/project/rightmove/commercial-property-to-rent 搜索英国商业地产出租房源
完整文档 →说明
按地区搜索商业地产出租房源,必填的 identifier 需取自自动补全结果中的 data[index].locationIdentifier。可选筛选条件包括租金上下限及 price_type、面积上下限及 size_unit、以逗号分隔的 property_type、search_radius、type_of_let、房源发布新近程度、停车条件,以及是否包含已达成租赁意向的房源;还可传入 page 和 sort_by。文档列出了搜索半径的可选值,但未说明距离单位,也未提供 sort_by 的可用值或每页条数上限。已观察到的成功响应为 JSON 对象,包含 status=true、字符串 message、对象数组 data,以及整数类型的 currentPage、resultsPerPage 和 totalResultCount。文档中尚未验证的局部示例还展示了房源行内的 id、displayAddress、displaySize、heading、location.latitude/longitude、customer.branchDisplayName,以及 price.amount/currencyCode/displayPrices;现有成功响应记录未逐项确认这些行级字段。分页遍历应以实际返回的分页值为依据,限制任务规模,并在续传检查点中保留筛选条件;房源和总数可能在请求之间变化。搜索成功不代表房源仍可租、符合法定用途,也不代表租金已经统一口径、可以直接比较。
调整条件并手动测试 必填 1 项 · 可选 14 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
展开更多筛选条件 (8)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/rightmove/commercial-property-to-rent-detail 按房源 ID 获取商业出租物业详情
完整文档 →说明
使用必填查询参数 id 获取一条商业出租房源的详情。文档说明该值来自 commercial/property-to-rent 搜索结果对象的 id 字段;接入时应确认这一对应关系,不要误用搜索所需的地区标识。尚未验证的局部文档示例在 data 对象中展示了 address.displayAddress、countryCode、incode 和 outcode,commercial 与 businessForSale 标志,commercialUseClasses 和 brochures 数组,以及 customer 下的 branchDisplayName、branchName、companyName 等字段。示例还包含 epcGraphs、floorplans 和 images 数组,其中可见的户型图字段包括 caption、resizedFloorplanUrls、type 和 url。该示例中的 bedrooms、bathrooms 和 broadband 均为 null。现有资料中未观察到此详情接口的成功响应,局部示例不能作为完整或保证返回的响应结构。不要将搜索接口的分页结构套用于本接口,也不能据详情查询推断房源当前可租、租约条款已确认或物业符合法定用途。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
商业地产出售
/api/project/rightmove/commercial-property-to-sale 搜索英国待售商业地产
完整文档 →说明
按必填的区域标识符搜索英国待售商业地产,并可选用价格、面积、物业类型、搜索半径、挂牌状态和页码筛选条件。identifier 应取自房产区域自动补全结果的 locationIdentifier,而不是房源 ID。property_type 接受以逗号分隔的文档所列代码;size_unit 用于指定 min_size 和 max_size 的面积单位。已观察到的成功请求使用 identifier=REGION^1036、page=1 和 search_radius=0.0,返回的 JSON 对象包含 status=true、字符串 message、由对象组成的 data 数组,以及整数类型的 currentPage、resultsPerPage 和 totalResultCount。这仅确认了响应外层结构,并不代表所有房源字段或筛选组合均已验证。文档中的截断示例另行展示了 displayAddress、displaySize、displayStatus、auction、firstVisibleDate 和 customer 等房源字段,但这些字段尚未逐一独立验证。详情接口文档说明其输入来自 data[].id。分页总数并非固定快照,挂牌价格不等于实际成交价,各类标志参数也不能视为已验证的严格排除规则。
调整条件并手动测试 必填 1 项 · 可选 15 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
展开更多筛选条件 (10)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/rightmove/commercial-property-to-sale-detail 按房源 ID 查询待售商业地产详情
完整文档 →说明
使用必填的字符串 id 获取所选待售商业地产的详情记录。id 应取自商业地产出售搜索结果中的 data[].id,请勿传入区域标识符。本接口没有提供已观察到的实际请求响应;现有文档示例已被截断,只能作为文档依据,不能视为经过验证的完整响应结构。示例可见部分包含一个 data 对象,其中列有 id、address、commercial、businessForSale、commercialUseClasses、customer、contactInfo、brochures、epcGraphs、floorplans,以及尚未完整展示的 images 数组。address 展示了 displayAddress、countryCode、deliveryPointId、outcode、incode 和 ukCountry;customer 包含 branchDisplayName、branchId 和 companyName;contactInfo 包含 contactMethod 和 telephoneNumbers。示例中的 EPC 条目带有 caption 和 url,但其他媒体条目的结构尚未确认。bathrooms、broadband、auctionProvider 等字段在示例中为 null,部分数组为空。请仅展示实际返回的字段,不要从搜索接口推断缺失的价格、土地持有权类型、租赁关系、所有权、在售状态或响应外层状态字段。本接口用于挂牌房源研究,不能作为已完成交易或产权登记的证明。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
成交价地点查询
/api/project/rightmove/house-prices-auto-complete 获取英国历史成交房价查询的区域建议
完整文档 →说明
使用必填的字符串 location,为英国历史成交房价研究表单查询候选区域。文档示例输入为 ch,未说明最短查询长度,也未列出分页控制或额外筛选条件。本接口没有提供已观察到的实际请求响应。未经验证的文档示例是一个 JSON 对象,包含布尔型 status、字符串 message,以及由候选区域对象组成的 data 数组。示例中每个候选对象包含字符串类型的 displayName、highlighting、id、locationIdentifier 和 type,以及 highlights 数组;该数组内的对象包含布尔型 highlighted 和字符串 text。示例的 type 值出现了 REGION,但不能据此认定只支持这一类型。请使用实际返回的标签,并对照后续房价搜索接口的输入约定核实所选标识符的映射关系;不要假定 id 与 locationIdentifier 可互换,也不要用通用房产区域自动补全替代本接口。本接口仅提供查询区域建议,不返回成交记录、房价、估值或挂牌房源记录。文档示例不能证明当前建议数量、覆盖范围、排序规则或更新时效。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
历史成交价
/api/project/rightmove/house-prices-details 按 UUID 查询房产历史记录详情
完整文档 →说明
使用必填查询参数 uuid 查询一条房产历史记录。按照文档流程,应从已售房价搜索结果中读取 data[].uuid(结果提供该字段时);不得用挂牌房源 ID 代替,也不得根据其他标识推算 UUID。目前没有此接口的实测响应可供参考。未经实测验证的响应示例包含布尔型 status、字符串 message 和对象型 data。示例中的 data 包括 address.displayAddress、detailUrl、propertyType、source、位置坐标与地图元数据,以及 disclaimer 中的 earliestTransaction、mostRecentTransaction 和 lastLoadDate 日期字段。propertyDetails 对象包含 id、bedrooms、bathrooms、soldPropertyLastListed、images、floorplans 和 streetView 元数据;交易示例包含 displayDeedDate、displayPrice、tenure、absoluteChangeType 和 displayAbsoluteChange。这些示例字段仅展示历史记录可能包含的内容,不保证实际返回,也不代表当前在售房源或房产估值。应保留日期和价格的原始展示字符串,不要假定它们是可直接计算的成交数值。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
/api/project/rightmove/house-prices-sold-house-prices 按地区搜索房屋历史成交价格
完整文档 →说明
搜索房产历史成交记录,必填参数 identifier 和 type 均来自房价地区自动补全结果:将 locationIdentifier 传入 identifier,将对应的 type 传入地区类型参数。可选的 date_sold、property_type、search_radius 和 sort_by 用于筛选或排序,page 用于指定结果页码。一次成功实测使用了 identifier=984、type=REGION、page=1 和 sort_by=DeedDate;HTTP 200 JSON 响应包含 status=true、字符串 message、元素为对象的 data 数组,以及独立的 meta 对象。该响应未出现可选的旧版顶层分页字段 currentPage、resultsPerPage 和 totalResultCount,因此不应要求它们必须存在,也不应预设 meta 内的具体字段。另一个不完整且未经实测验证的文档示例列出了 address、bedrooms、detailUrl、propertyType、images、location 和 transactions 等房产字段,其中交易信息包含 dateSold、displayPrice、newBuild 和 tenure。这些记录字段及示例中的分页信息均未由本次实测确认。文档中的详情查询流程在 data[].uuid 存在时使用该值,但本次实测不能证明每条记录都提供 UUID。此接口用于历史成交研究,不提供实时挂牌价,也不代表完整房产登记库或自动估值服务。
调整条件并手动测试 必填 2 项 · 可选 5 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
展开更多筛选条件 (1)
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
住宅租赁
/api/project/rightmove/property-to-rent 按居住需求筛选英国住宅出租房源
完整文档 →说明
通过租房地区自动补全结果 data[].locationIdentifier 中的完整地区标识搜索出租房源,identifier 为必填参数,文档示例为 REGION^1036。可选条件包括租金和卧室数量上下限、以逗号分隔的 furnished_type、property_type 和 keywords,以及 search_radius、page、配套设施标记、住宿类别的纳入与排除标记、added_to_site、sort_by 和 type_of_let。文档列出了家具配置、房产类型和搜索半径的示例值,但未说明 added_to_site、sort_by、type_of_let 的可用值、租金币种与计价周期,也未说明同类住宿纳入与排除标记之间的关系。 本接口暂无实际响应验证记录。不完整的文档示例包含 currentPage 和 data 数组,房源字段包括 id、displayAddress、bedrooms、bathrooms、location.latitude、location.longitude、listingUpdate、price 和 propertyImages。其中 price 对象展示了 amount、currencyCode、frequency,以及条目含 displayPrice 的 displayPrices;propertyImages 展示了 images 数组。这些仅为示例字段,并非已验证的响应结构,也不构成分页保证。用于搬家选房清单前,应核实实际返回的租金计价方式和住宿筛选行为,不应据此认定房源当前可租或结果覆盖全部房源。
调整条件并手动测试 必填 1 项 · 可选 21 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
展开更多筛选条件 (17)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/rightmove/property-to-rent-detail 按房源 ID 查询住宅出租详情
完整文档 →说明
通过必填查询参数 id 获取一条住宅出租房源的详情。请使用 property-to-rent 搜索结果中的 ID,并以字符串传入。文档默认值 135161867 仅为示例房源 ID,不代表该房源目前仍可租。不要假定住宅出售、商业地产或学生租房渠道的标识也适用于本接口。 文档中的成功响应示例包含 data 对象,其中 address 列出 countryCode、deliveryPointId、displayAddress、incode、outcode 和 ukCountry;bedrooms、bathrooms 为数值,channel 为字符串,commercial 为布尔值。示例还展示了包含 broadbandCheckerUrl 和 disclaimer 的 broadband、brochures 数组、包含 contactMethod 和 telephoneNumbers 的 contactInfo,以及包含 branchDisplayName、branchId、branchName 和 companyName 的 customer 对象。示例中存在可为 null 的值,brochures 为空数组,尚无法确定宣传册条目的内容。 本接口暂无实际响应验证记录。以上字段来自截断的文档示例,并非经过实际响应验证的结构,完整结构及字段可用性仍未确认。不能据此推断当前可租状态、租金或费用、承租资格,也不能认定接口支持看房预约或预订。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
学生住宿
/api/project/rightmove/student-property-to-rent 按地区、预算和房型搜索英国学生租房房源
完整文档 →说明
搜索英国学生租房房源时,必须通过查询参数 identifier 传入地区标识,该值取自 auto-complete 返回的 data[index].locationIdentifier。文档给出的 identifier 默认值为 REGION^1036。search_radius 为字符串,文档默认值为 0.0,支持 0.0、0.25、0.5、1.0、3.0、5.0、10.0、15.0、20.0、30.0 和 40.0,未说明距离单位。本接口不提供大学名称或步行时间参数。 可选数值参数包括 min_price、max_price、min_bedroom、max_bedroom 和 page。文档未说明价格币种、租金计价周期、页码规则或数值范围。furnished_type 支持以逗号分隔的 Furnished、PartFurnished 和 Unfurnished;property_type 支持以逗号分隔的 Detached、SemiDetached、Terraced、Flat、Bungalow 和 StudentHalls。keywords 为以逗号分隔的关键词字符串。可选布尔参数包括 has_garden、has_parking、has_house_share、do_not_show_house_share 和 has_include_let_agreed,其具体筛选方式及组合行为未作说明。added_to_site 和 sort_by 是可选字符串,文档未列出可接受的格式或代码。 文档中的成功响应示例并不完整,开头包含整数 currentPage 和由房源对象组成的 data 数组。可见房源字段包括数值类型的 id、bedrooms 和 bathrooms,字符串类型的 displayAddress、displaySize、channel、firstVisibleDate 和 addedOrReduced,布尔类型的 commercial,含 branchDisplayName 和 branchId 的 customer 对象,以及 keywords 数组。示例中的 distance 为 null,不能据此认定该字段会返回数值距离。本接口没有留存实际调用响应;上述字段仅来自文档示例,并非实测保证,也不能据此确认总数或其他分页字段。选中房源后,预期可将其 ID 传给 student-property-to-rent-detail 的必填字符串参数 id,但应先验证这一衔接。此搜索接口不能确认学生入住资格、距校园远近、费用是否包含在租金内、合同日期或预订事宜。
调整条件并手动测试 必填 1 项 · 可选 16 项
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
展开更多筛选条件 (12)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/rightmove/student-property-to-rent-detail 通过房源 ID 查询学生租房详情
完整文档 →说明
使用必填字符串查询参数 id 获取选中的学生租房详情,ID 应来自 student-property-to-rent 搜索结果。文档默认值为 132688508,该示例 ID 对应房源目前是否可用尚未核实。学生房源搜索的文档示例中,房源 ID 为数值;传入此字符串参数时应保留原有数字,并在生产环境使用前验证搜索到详情的衔接。不要假定普通住宅租赁、出售或商业房源的标识可以互换。 截断的成功响应文档示例包含 data 对象,其中 address 对象含 countryCode、deliveryPointId、displayAddress、incode、outcode 和 ukCountry。示例还展示了数值类型的 bedrooms 和 bathrooms、字符串类型的 channel、布尔类型的 commercial,含 broadbandCheckerUrl 和 disclaimer 的 broadband 对象、brochures 数组、含 contactMethod 和 telephoneNumbers 的 contactInfo,以及含 branchDisplayName、branchId、branchName 和 companyName 的 customer 信息。示例中部分字段为 null,brochures 为空数组,无法据此确定有内容时的宣传册条目结构。 本接口没有留存实际调用响应。上述字段均来自文档示例,并非经过实测的字段存在性保证,也不是完整响应结构。应仅展示所选学生房源实际返回的字段。现有资料不能确认合同日期、费用是否包含在租金内、学生入住资格、距大学远近、空房情况或住宿预订能力。
调整条件并手动测试 必填 1 项 · 可选 0 项
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
各接口能查询什么
为英国房产搜索、租房服务与市场研究工具接入地点建议、条件筛选、独立房源详情和历史成交价查询。
- 住宅出售与新房:按地区、预算、卧室数量、房产类型及各接口支持的条件筛选房源
- 普通租房与学生住宿:通过各自的搜索接口设置租金、卧室数量和家具配置等条件
- 商业地产:查找出租或出售物业,结合预算与面积区间筛选,并明确面积单位和出租计价口径
- 房源深入查看:使用对应类别的详情接口,并以选定房源为起点发现相似房源
- 历史成交价研究:使用专用地点建议和成交记录搜索,将已完成交易与当前挂牌报价分开分析
请分别核对各接口的标识符与响应元数据。搜索结果不代表英国全市场覆盖,也不保证房源仍然可用或各页属于同一时点的快照,不能替代房产估值。