§1概述
接口能力与数据说明
## 中国二手房挂牌数据查询API 该接口提供中国重点城市二手房挂牌信息数据，涵盖房屋基本信息、挂牌价格、房源描述、发布机构等关键字段。数据覆盖全国主要城市及区县，支持多维度筛选与分页查询，适用于房地产市场分析、房源评估、中介机构研究等场景。 ###  状态 覆盖全国主要城市，数据持续更新，当前版本为2025年6月版。 ###  覆盖时间范围 - 挂牌时间：当前版本以2025年6月前发布的挂牌信息为主。 ###  核心功能 - **全量挂牌记录查询**：一次性获取全国重点城市二手房挂牌明细，支持按省份、城市、小区等多维度筛选。 - **多维度筛选**：支持按省份、城市、小区名称、挂牌时间等条件灵活筛选挂牌数据。 - **关键属性覆盖**：提供建筑面积、房屋朝向、所在楼层、配备电梯、产权性质、房屋用途等深度信息，满足市场分析与研究需求。 ###  适用场景 - 城市与区域二手房挂牌价格趋势分析 - 房源特征与挂牌周期研究 - 中介机构活跃度与服务质量评估 - 房产估值模型构建与因子挖掘 - 挂牌房源文本挖掘与卖点分析 ### 错误码说明 | 错误码 | 返回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月版，涵盖该日期前成交记录。 ### 更新历史 | 版本 | 日期 | 变更说明 | | ---- | ---- | ---- | | v1.0.0 | 2025/6/1 | 初始版本发布，包含四百余万条二手房成交数据 |
请求地址
GET https://apiopendata.com/api/resold_apartment_sell_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开始使用
注册获取调用凭证，或联系销售获得机构级方案
状态
覆盖时间范围
核心功能
适用场景