按地区、预算和房型搜索英国学生租房房源

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

搜索英国学生租房房源时,必须通过查询参数 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,但应先验证这一衔接。此搜索接口不能确认学生入住资格、距校园远近、费用是否包含在租金内、合同日期或预订事宜。

API 功能

基于地区标识查找学生房源 将 auto-complete 的 locationIdentifier 用作 identifier,并选择文档支持的 search_radius 值开展地区搜索,不将其描述为按校园名称或步行时间筛选。
学生租房预算与卧室数区间 通过可选数值参数 min_price、max_price、min_bedroom 和 max_bedroom 提交筛选上下限;展示预算标签前,需另行核实价格单位和租金计价周期。
家具配置与学生公寓房型选择 使用文档列出的 furnished_type 和 property_type 逗号分隔取值表达住宿偏好,包括 StudentHalls,不自行编造房型代码。
分别设置合租筛选选项 将 has_house_share 与 do_not_show_house_share 作为两个独立的可选开关,核实各自及组合行为后,再向用户提供有明确含义的合租筛选。
按实际返回字段展示学生搜索结果 未经实测的文档示例包含 currentPage,以及带有 id、displayAddress、bedrooms、bathrooms 和 customer 信息的 data 房源条目,可据此设计兼容字段缺失的结果展示。

在线 API 演示

GET /api/project/rightmove/student-property-to-rent

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

学生租房搜索必填的 identifier 从哪里获取?

取 auto-complete 返回的 data[index].locationIdentifier,并以字符串传入 identifier。文档默认值为 REGION^1036。本接口不提供大学名称输入项,仅凭地区标识也不能确定房源距校园的距离。

家具配置、房型和搜索半径有哪些文档支持的取值?

furnished_type 支持以逗号分隔的 Furnished、PartFurnished 和 Unfurnished。property_type 支持 Detached、SemiDetached、Terraced、Flat、Bungalow 和 StudentHalls,也以逗号分隔。search_radius 支持字符串 0.0、0.25、0.5、1.0、3.0、5.0、10.0、15.0、20.0、30.0 和 40.0,默认值为 0.0,文档未说明其单位。

学生租房的价格上下限按周租还是月租计算?

文档未说明 min_price 和 max_price 的币种或租金计价周期。这两个参数都是可选数值。核实实际行为前,不应将其标注为周租、月租或某一特定币种。

两个合租开关可以视为互相抵消吗?

不可以。has_house_share 和 do_not_show_house_share 是两个独立的可选布尔参数,文档未说明各自取 true 或 false 时的行为及相互作用。应先测试所需配置再据此筛选;花园、停车和已达成租赁协议相关开关也需要同样谨慎处理。

学生租房搜索的哪些响应结构已得到验证?

本接口没有保存实际调用响应。截断的文档示例展示了 currentPage,以及包含 id、displayAddress、卧室数、浴室数、customer 信息等字段的 data 房源条目。该示例不能确认完整分页结构、非空距离、学生入住资格、费用是否包含在租金内或合同日期。

如何查看选中学生房源的详情?

预期下一步是调用 student-property-to-rent-detail,并传入其必填的字符串参数 id。搜索文档示例中的 id 为数值,转换为字符串时应保留原有数字。现有资料未通过实际调用验证搜索到详情的衔接,不应替换为普通住宅或商业房源的 ID。

相关接口

相关指南

查看订阅方案 →