数据 API 服务

稳定、准确、开箱即用的数据 API

全国五级行政区划,一个接口查完。按次计费,成功才扣费。

请求查询北京市朝阳区的区划详情
curl https://api.yuanputech.com/area/v1/regions/110105 \
  -H "X-API-Key: ak_live_3fA9xxxxxxxxxxxx"
响应HTTP 200 · application/json
{
  "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。

选择省级行政区
每天可体验 20 次,仅开放省、市两级

选择省份后,这里会列出它的下级行政区划。数据为 2024 年度统计用区划代码。

区划详情体验版 · 省 / 市两级
还没有选择行政区划在左边选择省份,再点一个下级行政区划,这里会显示它的代码、层级、上级代码与完整路径。

免登录体验每天 20 次,仅开放省、市两级。注册后免费试用 7 天 / 1,000 次,开放五级数据与全部接口。

产品矩阵

一个账号、一套鉴权、一份额度,覆盖陆续上线的所有数据 API。

五级行政区划查询 API

可用

省、市、县、乡镇、村五个级别的行政区划代码与名称,支持逐级下钻、条件筛选、名称搜索、子树导出与批量查询。数据按年度随国家统计局统计用区划代码更新。

数据总量665,552 条接口数量6 个数据版本2024 年度计费方式按次 / 包月 / 包季 / 包年

更多数据 API 即将上线

筹备中

新产品会沿用同一套鉴权、计费与控制台。上线前不会在这里预告具体名称。

更多数据 API 即将上线

筹备中

有想接入的数据类型,欢迎通过页脚的商务邮箱告诉我们。

为什么选这套接口

覆盖完整、响应够快、计费讲理、密钥可控。

665,552条数据 · 2024 年度统计用区划代码
31省级
343地级
3,255县级
41,351乡镇级
620,572村级

数据覆盖到村一级

省、市、县、乡镇、村五个级别全量收录,村级 620,572 条。每条记录带统计用区划代码,村级另带城乡分类代码。

毫秒级响应与多级缓存

全量数据常驻内存与边缘缓存,高频查询直接命中。缓存命中同样计费,这一点在计费规则里写明,不做模糊表述。

按次计费,成功才扣费

只有 HTTP 200 且业务 code = 0 的调用才扣减额度。参数错误、鉴权失败、区划不存在都不计费。

可用性目标 99.9%

这是我们对外承诺的服务可用性目标,不是已经统计出来的历史数据。正式的服务等级协议会在服务条款中单独约定。

API Key 与 IP 白名单

完整 Key 仅在创建时显示一次,之后只显示前缀与遮罩。每个 Key 可单独配置 IP 白名单,白名单外的请求返回 40301。

额度与用量自己看得见

控制台显示剩余额度、到期时间与近 7 天调用量;额度低于阈值或即将到期会提前提醒,不会悄悄断掉。

三步接入

从注册到第一次成功调用,通常十分钟以内。

注册账号

用邮箱或手机号加验证码注册,可以先不设密码。注册时需要同意《用户服务协议》与《隐私政策》。

去注册

开通试用,拿到 Key

在控制台开通免费试用,获得 7 天 / 1,000 次额度与 1 个 API Key。完整 Key 只显示一次,请立刻保存。

查看额度

发起第一次调用

把 Key 放进 X-API-Key 请求头,复制文档里的示例直接跑。文档提供六种语言的代码与在线调试。

快速开始
定价

按用量选,随时升级

全部套餐共用同一套接口与文档,升级后 Key 和配置不变。

免费试用

先验证接口再付费
免费/ 7 天
共 1,000 次QPS 21 个 Key

按量充值

用多少买多少
0.0058元 / 次
自选金额,10 元起QPS 103 个 Key

包月

调用量稳定
¥29/ 月
30 万次 / 月QPS 205 个 Key

包季

季度结算
¥79/ 季
100 万次QPS 205 个 Key

只有成功调用才计费。多个套餐同时有效时先扣试用与订阅额度、再扣充值余额,同类之间先到期的先扣。完整规则见定价页。

先免费跑通,再谈付费

注册即可开通 7 天 / 1,000 次免费试用,不绑卡、不自动续费。