按地区搜索房屋历史成交价格

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

搜索房产历史成交记录,必填参数 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。此接口用于历史成交研究,不提供实时挂牌价,也不代表完整房产登记库或自动估值服务。

API 功能

地区标识与类型配对检索 同时使用房价地区自动补全提供的 identifier 和 type。成功实测采用 984 与 REGION 配对,而不是带前缀的租房搜索标识。
按成交年限与房屋类别筛选 使用文档列出的 date_sold 年限和 property_type 类别缩小历史成交研究范围,房屋类别包括 DETACHED、SEMI_DETACHED、TERRACED 和 FLAT。
按最近成交、价格或地址排序 sort_by 只接受一个排序值:DeedDate 表示最近成交,也可选择 PriceAsc、PriceDesc 或 Address。成功实测使用的是 DeedDate。
已验证的成交列表响应结构 成功实测返回 status=true、字符串 message、元素为对象的 data 数组和独立的 meta 对象,未包含可选的旧版顶层分页字段。
结合英里半径分区域浏览 将文档中以英里为单位的 search_radius 与 page 配合使用;在判断可获取多少页之前,先检查实际返回的元数据。

在线 API 演示

GET /api/project/rightmove/house-prices-sold-house-prices

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/rightmove/house-prices-sold-house-prices?key=<API_KEY>&identifier=984&page=1&search_radius=0&sort_by=DeedDate&type=REGION'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

已售房价搜索所需的 identifier 和 type 如何获取?

使用房价地区自动补全接口,将结果中的 locationIdentifier 作为 identifier,将 type 作为同名参数传入。这两个查询参数均为必填项。成功实测使用了 identifier=984 和 type=REGION。

哪些响应字段经过了实际验证?

成功的 HTTP 200 响应包含 status=true、字符串 message、元素为对象的 data 数组和一个 meta 对象。现有证据不能确定每条房产记录的固定结构,也不能确定 meta 内有哪些具体字段。

可以依赖顶层的 currentPage 或 totalResultCount 吗?

不可以。currentPage、resultsPerPage 和 totalResultCount 是文档中列出的可选旧版字段,实测响应中并未出现。应保留 meta 并检查其实际内容,再推导总页数或后续翻页方式。文档中的 page 默认值为 1。

date_sold 和 sort_by 可以使用哪些值?

文档中的 date_sold 示例包括 1、2、3、5、10、15、20 和 30,分别表示过去相应年数内的成交记录;不传则不限成交年限。sort_by 每次只能传一个值:DeedDate、PriceAsc、PriceDesc 或 Address。文档默认排序值与成功实测使用的值均为 DeedDate。

每条结果都提供可查询历史详情的 UUID 吗?

本次实测不能确认这一点。文档中的历史详情查询流程仅在 data[].uuid 存在时使用该值。只应为实际包含 uuid 的记录启用按 UUID 查看详情的功能,不要从其他字段推算 UUID。

这是实时房源数据或估值服务吗?

不是。它是用于研究的房产历史成交搜索接口。现有证据不能证明其覆盖所有地区、实时更新,或具备自动估值能力。

相关接口

相关指南

查看订阅方案 →