§1概述
接口能力与数据说明
## 中国小区信息数据 该接口提供全国重点城市住房小区分布信息数据，涵盖小区基本信息、位置信息、建筑指标、价格信息及物业配套等关键字段。数据覆盖全国28个省级行政区、102个重点城市，支持多维度筛选与分页查询，适用于房地产市场分析、城市发展研究、住房空置率测算等场景。 ###  状态 覆盖全国102个重点城市，数据持续更新，当前版本截至2024年11月。 ###  覆盖时间范围 截至2024年11月 ###  核心功能 - **全量小区信息查询**：一次性获取全国重点城市住房小区明细，支持按省份、城市、行政区、板块等多维度筛选。 - **多维度筛选**：支持按城市等级、小区名称、建成年代、房屋用途、建筑类型、物业公司等条件灵活筛选。 - **关键属性覆盖**：提供小区均价、楼栋总数、房屋总数、在售/在租数量、容积率、绿化率、物业费用、停车位信息、供暖用水用电类型等深度信息，满足市场分析与研究需求。 - **位置坐标支持**：提供经度、纬度字段，支持地理位置关联分析与空间可视化。 ###  适用场景 - 城市与区域住房小区分布特征分析 - 房屋空置率测算与房地产调控政策效果评估 - 房价趋势预测与住宅估值模型构建 - 城市发展水平与城镇化进程研究 - 小区配套与物业服务质量对比研究 ### 错误码说明 | 错误码 | 返回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. 数据每年更新一次，当前版本为2024年12月版。 ### 更新历史 | 版本 | 日期 | 变更说明 | | ---- | ---- | ---- | | v1.0.0 | 2026/3/27 | 初始版本发布 |
请求地址
GET https://apiopendata.com/api/housing_estate_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开始使用
注册获取调用凭证，或联系销售获得机构级方案
状态
覆盖时间范围
核心功能
适用场景