§1概述
接口能力与数据说明
## 中国二手房成交数据查询API 该接口提供中国重点城市二手房成交记录数据，涵盖房屋基本信息、交易价格、成交周期、地理位置等关键字段。数据覆盖全国主要城市及区县，支持多维度筛选与分页查询，适用于房地产市场分析、价格趋势研究及区域价值评估等场景。 ###  状态 覆盖全国主要城市，数据持续更新，当前版本为2025年6月版。 ###  覆盖时间范围 - 支持回溯至历史成交记录，当前版本以2025年6月前成交数据 ###  核心功能 - **全量成交记录查询**：一次性获取全国重点城市二手房成交明细，支持按城市、区县等维度筛选。 - **多维度筛选**：支持按省份、城市、区县、签约年份、小区名称等条件灵活筛选成交数据。 - **关键属性覆盖**：提供户型、朝向、面积、楼层、签约日期、成交价、挂牌价、单价、成交周期等深度信息，满足市场分析与研究需求。 - **地理位置标注**：包含小区经纬度（bd09坐标系），便于空间分析与地图可视化。 ###  适用场景 - 城市与区域二手房市场价格走势分析 - 板块热度与成交周期评估 - 房屋交易价格与挂牌价差异研究 - 房产估值模型构建与因子挖掘 - 地理空间分析与区域价值评估 ### 错误码说明 | 错误码 | 返回message | 含义 | | ---- | ---- | ---- | | 0 | success | 成功 | | 40001 | Missing valid token in request | 请求中缺少Token | | 40002 | Invalid token | Token无效 | | 50001 | Too Many Requests: API call frequency limit exceeded | 请求过多：超出 API 调用频率限制 | | 50002 | Unknown error | 未知错误 | ### 注意事项 1. 数据每年更新一次，当前版本为2025年6月版，涵盖该日期前成交记录。 2. 成交价、挂牌价等字段为成交时点价格，不反映当前市场估值。 ### 更新历史 | 版本 | 日期 | 变更说明 | | ---- | ---- | ---- | | v1.0.0 | 2025/6/1 | 初始版本发布，包含四百余万条二手房成交数据 |
请求地址
GET https://apiopendata.com/api/resold_apartment_turnover_china注册后可获取 API Key；如需更高调用配额、批量服务或专属支持，可联系销售顾问。
§2请求参数
调用接口所需的查询参数
§3数据字段
返回结果中的字段定义
§4代码示例
Python / R / Stata 调用示例
import requests
url = "https://api.cnopendata.com/v1/..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
params = {}
resp = requests.get(url, headers=headers, params=params)
data = resp.json()
print(data)§5开始使用
注册获取调用凭证，或联系销售获得机构级方案
状态
覆盖时间范围
核心功能
适用场景