🏙 城市数据开放 API
把鸥维数据的全国区域经济库接入你的应用:地级市GDP、人均 GDP、增速、三产占比,含多年历史序列,5 个只读接口。
2025最新数据年份
340+地级市
2000+区县
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/city/overview"
响应头会返回当日配额:X-Quota-Limit / X-Quota-Used。超限返回 429,Key 无效返回 401。
③ 接口列表 全部为 GET · 本服务 ¥899/年
GET/api/ow/city/overview
数据概览:可用数据表(省/市/区县)与字段说明、最新年份。
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/city/overview"
GET/api/ow/city/areas
行政区划列表(拿到 code)。
| 参数 | 必填 | 说明 |
|---|
| level | 否 | 1=省 / 2=市 / 3=区县 |
| parent | 否 | 上级 code,如 440000(广东) |
| q | 否 | 名称模糊搜索 |
| page / limit | 否 | limit 最大 500 |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/city/areas?level=2&q=深圳"
GET/api/ow/city/gdp
某地区 GDP 历史序列(自动匹配省/市/区县表)。
| 参数 | 必填 | 说明 |
|---|
| code | 是 | 行政区划代码,如 440300 |
| from / to | 否 | 年份范围,如 from=2015 |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/city/gdp?code=***&from=2015"
GET/api/ow/city/latest
某地区最新一年 GDP / 人均 / 增速。
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/city/latest?code=***"
GET/api/ow/city/ranking
GDP 排行(按最新或指定年份)。
| 参数 | 必填 | 说明 |
|---|
| level | 否 | 1=省 / 2=市 / 3=区县,默认 2 |
| year | 否 | 如 2025,默认最新 |
| limit | 否 | 最大 500,默认 50 |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/city/ranking?level=2&year=2025&limit=10"
④ 返回示例
{
"ok": true,
"code": 200,
"data": {
"name": "深圳", "code": "440300", "level": 2, "table": "city_gpd",
"year": 2025, "gdp": 38731.8, "per": 213763, "growth": 5.5
}
}
字段说明:gdp 地区生产总值(亿元);per 人均 GDP(元);growth 增速(%);share 三产占比(%)。
错误码:401 Key 缺失/无效 · 403 Key 未开通/已停用/已到期 · 404 未找到数据 · 429 超出当日配额 · 422 参数错误。
⑤ 使用条款
1. 数据整理自公开渠道,仅供研究与产品展示参考,不构成投资建议;
2. 请注明数据来源“鸥维数据(www.oweidata.com)”;
3. 禁止转售、二次分发原始数据或进行高频爬取;
4. 本服务含 1000 次/日 调用额度;如需更高配额或商用授权,请通过页脚「关于我们」联系我们。
