按地区、预算和房型搜索英国学生租房房源
查看 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 为即将入学的学生建立租房候选清单:先单独解析大学周边地区标识,再结合半径和家具偏好搜索,但不承诺到校园的步行距离。
- 让住宿顾问对照卧室数区间和提交的价格上下限筛选房源,租金币种与计价周期在核实前不作确定标注。
- 测试两个合租开关后,为学生合租与其他住宿需求分别配置搜索条件,而非假定这两个开关互为相反选项。
- 使用文档支持的 StudentHalls 房型构建学生公寓浏览页,且只展示实际搜索响应中存在的房源字段。
- 确认分页行为后,使用数值参数 page 请求下一页学生房源,并保留选中房源的 ID,供另行验证过的学生房源详情查询使用。
常见问题
学生租房搜索必填的 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。