获取英国历史成交房价查询的区域建议
查看 Rightmove 英国房产搜索与成交价查询 的全部接口 →使用必填的字符串 location,为英国历史成交房价研究表单查询候选区域。文档示例输入为 ch,未说明最短查询长度,也未列出分页控制或额外筛选条件。本接口没有提供已观察到的实际请求响应。未经验证的文档示例是一个 JSON 对象,包含布尔型 status、字符串 message,以及由候选区域对象组成的 data 数组。示例中每个候选对象包含字符串类型的 displayName、highlighting、id、locationIdentifier 和 type,以及 highlights 数组;该数组内的对象包含布尔型 highlighted 和字符串 text。示例的 type 值出现了 REGION,但不能据此认定只支持这一类型。请使用实际返回的标签,并对照后续房价搜索接口的输入约定核实所选标识符的映射关系;不要假定 id 与 locationIdentifier 可互换,也不要用通用房产区域自动补全替代本接口。本接口仅提供查询区域建议,不返回成交记录、房价、估值或挂牌房源记录。文档示例不能证明当前建议数量、覆盖范围、排序规则或更新时效。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/rightmove/house-prices-auto-complete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/rightmove/house-prices-auto-complete?key=<API_KEY>&location=<location>'
查询结果
使用场景
- 为英国历史成交房价研究表单添加专用区域选择器,仅使用文档列出的 location 文本作为查询输入。
- 展示返回的候选区域名称及类型值,帮助研究人员区分名称相近的城镇或地区。
- 将所选区域的 id 与 locationIdentifier 保存在不同表单字段中,直到确认它们与房价搜索输入的映射关系。
- 构建安全的文本建议列表,仅在返回片段的 highlighted 为 true 时对相应 highlights 文本进行强调显示。
常见问题
location 参数接受什么输入?
location 是必填字符串,用于查找房价研究的候选区域,文档示例为 ch。所提供文档没有说明最少字符数、默认查询、分页参数或额外筛选条件。
文档列出了哪些响应字段,是否经过实际观察?
本接口没有提供已观察到的实际响应。文档示例展示了包含 status、message 和 data 数组的对象,候选对象中列有 displayName、highlighting、highlights、id、locationIdentifier 和 type。这些是文档示例字段,不应视为已验证且必定返回的字段。
后续搜索应使用所选区域的 id 还是 locationIdentifier?
文档示例将两者列为不同的字符串字段。请同时保留,并在决定传入哪个字段前核实后续房价搜索接口的输入约定。现有依据无法证明它们可以互换,也无法证明它们等同于通用房源自动补全返回的标识符。
如何在不信任内嵌标记的前提下显示匹配文本?
示例除了独立的 highlighting 字符串,还包含带 text 和 highlighted 字段的 highlights 对象。建议将文本片段转义后,由应用控制强调样式;如需渲染标记内容,应先做安全清理。高亮结构尚未经过独立验证。
自动补全是否返回成交价,或覆盖英国所有地区?
该自动补全示例没有展示价格或交易记录,只用于提供区域建议。示例不能证明覆盖完整、建议数量固定、排序有保证或数据具备特定时效。REGION 只是示例中的类型值,并非已证实的完整类型列表。