按地区搜索房屋历史成交价格
查看 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 创建按地区展示的已完成交易研究页面,使用文档列出的成交年限与房屋类型筛选记录。
- 按最近成交或展示价格整理待人工审核的可比成交案例,不将其包装成自动估值结果。
- 实现兼容缺省字段的成交房价解析逻辑,保留对象型 meta,并允许旧版顶层分页字段缺失。
- 对比用户明确选择的不同搜索半径内的历史成交结果,并与当前挂牌房源数据分开展示。
- 构建分页浏览已售房产的研究流程,读取实际分页元数据后再启用翻页控件。
常见问题
已售房价搜索所需的 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。
这是实时房源数据或估值服务吗?
不是。它是用于研究的房产历史成交搜索接口。现有证据不能证明其覆盖所有地区、实时更新,或具备自动估值能力。