🏠 房价数据开放 API

把鸥维数据的全国房价库接入你的应用:覆盖全国地级市、区县、乡镇与开发区,提供二手房均价、环比、同比与历史月度序列。

2026-09最新数据月份

3,725覆盖地区数

2011-01 起历史序列

1000次/日(额度)

① 开通房价数据 API 仅注册用户 · 支付后立即发放 Key

本服务为付费服务,且仅限注册用户开通。请先登录(或注册),登录后在本页在线支付,支付成功立即获得专属 API Key。

② 调用方式

在请求头携带 X-API-Key(推荐),或加查询参数 ?key=。返回统一为 JSON:{"ok":true,"code":200,"data":{...}}

curl -H "X-API-Key: ow_你的key" "https://www.oweidata.com/api/ow/house/overview"

响应头会返回当日配额:X-Quota-Limit / X-Quota-Used。超限返回 429,Key 无效返回 401。

③ 接口列表全部为 GET

GET/api/ow/house/overview

数据概览:最新月份、覆盖地区数与各层级数量、字段说明。适合做接入前的连通性自检。

curl -H "X-API-Key: ow_你的key" "https://www.oweidata.com/api/ow/house/overview"

GET/api/ow/house/regions

地区列表(用于拿到 code)。

参数	必填	说明
level	否	city / district / zone / town
q	否	名称模糊搜索,如 `深圳`
page / limit	否	分页,limit 最大 200,默认 50

curl -H "X-API-Key: ow_你的key" "https://www.oweidata.com/api/ow/house/regions?level=city&q=深圳"

GET/api/ow/house/latest

某地区最新一期房价(含环比、同比)。

参数	必填	说明
code	三选一	行政区划代码,如 440300(深圳)
src_id	三选一	数据源地区 ID,如 49
name	三选一	地区名称,如上海

curl -H "X-API-Key: ow_你的key" "https://www.oweidata.com/api/ow/house/latest?code=440300"

GET/api/ow/house/history

历史月度序列(月度均价 + 环比 + 同比)。

参数	必填	说明
code / src_id	二选一	地区标识
from / to	否	月份范围 YYYY-MM,如 from=2021-01

curl -H "X-API-Key: ow_你的key" "https://www.oweidata.com/api/ow/house/history?code=440300&from=2025-01"

GET/api/ow/house/ranking

某层级房价排行(可用于做榜单)。

参数	必填	说明
level	否	city / district / zone / town,默认 city
month	否	YYYY-MM,默认最新
order	否	price(均价,默认)/ mom(环比)/ yoy(同比)
limit	否	最大 500,默认 50

curl -H "X-API-Key: ow_你的key" "https://www.oweidata.com/api/ow/house/ranking?level=city&order=price&limit=10"

④ 返回示例

{ "ok": true, "code": 200, "data": { "count": 1, "list": [ { "code": "440300", "name": "深圳", "level": "city", "province": "广东省", "ym": "2026-09", "ershou_price": 62870.0, "mom": 5.97, "yoy": 0.02 } ] } }

字段说明:ershou_price 二手房均价(元/㎡);mom 环比(%);yoy 同比(%)。
错误码:401 Key 缺失/无效 · 403 Key 未开通/已停用/已到期 · 404 未找到数据 · 429 超出当日配额 · 422 参数错误。

⑤ 使用条款

1. 数据整理自公开渠道,仅供研究与产品展示参考,不构成投资建议;
2. 请注明数据来源“鸥维数据(www.oweidata.com)”;
3. 禁止转售、二次分发原始数据或进行高频爬取;
4. 本服务含 1000 次/日调用额度;如需更高配额或商用授权,请通过页脚「关于我们」联系我们。