五级行政区划查询 API
可用省、市、县、乡镇、村五个级别的行政区划代码与名称,支持逐级下钻、条件筛选、名称搜索、子树导出与批量查询。数据按年度随国家统计局统计用区划代码更新。
curl https://api.yuanputech.com/area/v1/regions/110105 \
-H "X-API-Key: ak_live_3fA9xxxxxxxxxxxx"{
"code": 0,
"message": "ok",
"data": {
"code": "110105000000",
"name": "朝阳区",
"level": 3,
"level_name": "县级",
"parent_code": "110100000000",
"category": null,
"category_name": null,
"full_name": "北京市朝阳区",
"path": [
{ "code": "110000000000", "name": "北京市", "level": 1 },
{ "code": "110100000000", "name": "市辖区", "level": 2 },
{ "code": "110105000000", "name": "朝阳区", "level": 3 }
]
},
"request_id": "01a1de45-b941-7023-ad31-ad6eb03fcaf8"
}选一个省份,看它的下一级行政区划,点进去看完整字段和路径。不需要账号,不需要 API Key。
选择省份后,这里会列出它的下级行政区划。数据为 2024 年度统计用区划代码。
免登录体验每天 20 次,仅开放省、市两级。注册后免费试用 7 天 / 1,000 次,开放五级数据与全部接口。
覆盖完整、响应够快、计费讲理、密钥可控。
省、市、县、乡镇、村五个级别全量收录,村级 620,572 条。每条记录带统计用区划代码,村级另带城乡分类代码。
全量数据常驻内存与边缘缓存,高频查询直接命中。缓存命中同样计费,这一点在计费规则里写明,不做模糊表述。
只有 HTTP 200 且业务 code = 0 的调用才扣减额度。参数错误、鉴权失败、区划不存在都不计费。
这是我们对外承诺的服务可用性目标,不是已经统计出来的历史数据。正式的服务等级协议会在服务条款中单独约定。
完整 Key 仅在创建时显示一次,之后只显示前缀与遮罩。每个 Key 可单独配置 IP 白名单,白名单外的请求返回 40301。
控制台显示剩余额度、到期时间与近 7 天调用量;额度低于阈值或即将到期会提前提醒,不会悄悄断掉。
全部套餐共用同一套接口与文档,升级后 Key 和配置不变。
只有成功调用才计费。多个套餐同时有效时先扣试用与订阅额度、再扣充值余额,同类之间先到期的先扣。完整规则见定价页。