👥 人口数据开放 API 需 API Key
第七次全国人口普查(2020)数据开放调用:覆盖全国 31 个省级地区及地市、区县的人口总数、男女构成、性别比、城镇/乡村人口、户数与户规模。需在请求中携带专属 API Key。
3,364数据条数
31覆盖省级地区
14.10亿全国人口总数
104.8全国性别比
¥299年费 / Key
① 开通 人口数据 API 仅注册用户 · 支付后立即发放 Key
本服务为付费服务(¥299/年),且仅限注册用户开通。请先登录(或注册),登录后在本页在线支付,支付成功立即获得专属 API Key。
登录 / 注册后开通
② 调用方式
在请求头携带 X-API-Key(推荐),或加查询参数 ?key=***。返回统一为 JSON:{"ok":true,"code":200,"data":{...}},中文不转义。Key 为全站通用,各数据服务分别计到期时间(开通本服务不影响你已开通的其他 API)。
curl -H "X-API-Key: ***<你的Key>" "https://www.oweidata.com/api/ow/population/ranking?limit=10"
单次请求最多返回 200 条;每日调用额度以你的 Key 配额为准(响应头 X-Quota-Limit / X-Quota-Used)。超限 429,Key 无效 401,未开通/到期 403。
③ 接口列表 全部为 GET
GET/api/ow/population/overview
数据概览:普查年份、数据来源、总条数、覆盖省级地区数、全国汇总(人口/男女/性别比/城镇乡村/户数),以及字段说明与全部接口路径。
curl -H "X-API-Key: ***<你的Key>" "https://www.oweidata.com/api/ow/population/overview"
GET/api/ow/population/provinces
31 个省级地区汇总,按人口降序(含排名)。
curl -H "X-API-Key: ***<你的Key>" "https://www.oweidata.com/api/ow/population/provinces"
GET/api/ow/population/list
全量数据分页查询(全国 / 省级 / 地市 / 区县),支持省份筛选、关键词模糊匹配与多列表格排序。
| 参数 | 必填 | 说明 |
|---|
| province | 否 | 省级地区名,如 广东(不要带「省」) |
| keyword | 否 | 地区名 / 省份名模糊匹配,如 深圳 |
| sort | 否 | population(默认)/ male / female / sex_ratio / urban / rural / households |
| order | 否 | desc(默认)/ asc |
| page | 否 | 页码,默认 1 |
| limit | 否 | 每页条数,最大 200,默认 20 |
curl -H "X-API-Key: ***<你的Key>" "https://www.oweidata.com/api/ow/population/list?province=广东&sort=population&order=desc&limit=10"
GET/api/ow/population/ranking
人口排行(默认全国所有地区,含全国汇总行)。
| 参数 | 必填 | 说明 |
|---|
| scope | 否 | all(默认,全部地区)/ province(仅省级地区) |
| limit | 否 | 最大 200,默认 50 |
curl -H "X-API-Key: ***<你的Key>" "https://www.oweidata.com/api/ow/population/ranking?scope=province&limit=10"
GET/api/ow/population/detail
单个地区明细。
| 参数 | 必填 | 说明 |
|---|
| id | 是 | 地区记录 ID(可从 list / ranking 返回中获得) |
curl -H "X-API-Key: ***<你的Key>" "https://www.oweidata.com/api/ow/population/detail?id=3012330"
④ 返回示例
{
"ok": true,
"code": 200,
"data": {
"province": "广东", "sort": "population", "order": "desc",
"page": 1, "limit": 2, "total": 146, "total_pages": 73, "count": 2,
"list": [
{ "rank": 1, "id": 3012330, "name": "广东省", "province": "广东",
"province_code": "440000", "level": "province", "population": 126012510,
"male": 66873646, "female": 59138864, "sex_ratio": "113.08",
"urban": 93436072, "rural": 32576438, "households": 42469178, "household_size": "2.63" }
]
}
}
字段说明:level 层级(country 全国 / province 省级 / sub 地市区县) · population 人口总数 · male/female 男女人数 · sex_ratio 性别比(女=100) · urban/rural 城镇/乡村人口 · households 户数 · household_size 户规模。
错误码:401 Key 缺失/无效 · 403 Key 未开通本服务/已停用/已到期 · 404 未找到数据 · 429 超出当日配额 · 422 参数错误。
⑤ 使用条款
1. 数据来自国家统计局公开公报,仅供研究与产品展示参考,不构成投资建议;
2. 请注明数据来源“鸥维数据(www.oweidata.com)”;
3. 授权用于你方自有产品接入,禁止转售、二次分发原始数据或高频爬取;
4. 服务按年计费(¥299/年),到期前续费自动顺延;如需更高配额或商用授权,请通过页脚「关于我们」联系我们。
