中文地址解析

API

一行 API 从中文地址字符串中提取「省市区街道 + 详细地址 + 姓名 + 手机号 + 邮编」。适用场景：电商收货地址自动拆分、快递下单页智能填充、CRM 客户资料清洗、办公地址结构化入库。特点：纯本地正则算法，无任何服务依赖，毫秒级响应；支持 34 个省级行政区及其简称识…

文档

由极数本源提供·更新于昨天

303

累计调用

7ms

平均响应

100.00%

服务可用性

1,000 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 20

今日已用 0 / 1,000 次/日0.0%

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

每日 100 次 · QPS 2

登录免费

当前方案

每日 1,000 次 · QPS 20

黄金会员

每日 50,000 次 · QPS 60

企业会员

每日 1,000,000 次 · QPS 120

文档链接

复制文档地址

https://apizero.cn/aidocs/address-parse/raw.md

接口请求地址

https://v1.apizero.cn/api/address-parse

接口请求方式

POST

请求参数格式

APPLICATION/JSON

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/address-parse

接口信息备注

未登录匿名 1 QPS · 50 次/日；已登录默认 20 QPS · 1000 次/日（按账号等级浮动）

请求参数说明

名称	类型	说明
address	string	必填 · 中文地址字符串。支持姓名/手机/邮编混合输入，长度 ≤ 500 · 示例：张三 13812345678 上海市浦东新区张江镇科苑路88号 201203

请求头说明

名称	类型	说明
Authorization	string	可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

返回字段说明

名称	类型	说明
data.original	string	原始输入地址（未做任何处理）
data.province	string	省 / 直辖市 / 自治区 / 特别行政区全称
data.city	string	地级市 / 州 / 盟 / 地区（直辖市等于省）
data.district	string	区 / 县 / 县级市 / 旗
data.street	string	街道 / 乡 / 镇 / 路 / 大道 / 街 / 巷 / 弄
data.detail	string	门牌号 / 楼栋 / 单元等详细地址
data.zipcode	string	邮政编码（未识别时为空字符串）
data.phone	string	手机号（未识别时为空字符串）
data.name	string	收件人姓名（未识别时为空字符串）
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "original": "张三 138****1234 上海市浦东新区张江镇科苑路88号 201203",
    "province": "上海市",
    "city": "上海市",
    "district": "浦东新区",
    "street": "张江镇",
    "detail": "科苑路88号",
    "zipcode": "201203",
    "phone": "138****1234",
    "name": "张三"
  },
  "request_id": "kx8n9q2a1b3c4d5e6f7g",
  "tips": "极数本源 · https://apizero.cn"
}

加载接口文档…

名称

类型

说明

address

string

必填 · 中文地址字符串。支持姓名/手机/邮编混合输入，长度 ≤ 500 · 示例：张三 13812345678 上海市浦东新区张江镇科苑路88号 201203

名称

类型

说明

Authorization

string

可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

名称

类型

说明

data.original

string

原始输入地址（未做任何处理）

data.province

string

省 / 直辖市 / 自治区 / 特别行政区全称

data.city

string

地级市 / 州 / 盟 / 地区（直辖市等于省）

data.district

string

区 / 县 / 县级市 / 旗

data.street

string

街道 / 乡 / 镇 / 路 / 大道 / 街 / 巷 / 弄

data.detail

string

门牌号 / 楼栋 / 单元等详细地址

data.zipcode

string

邮政编码（未识别时为空字符串）

data.phone

string

手机号（未识别时为空字符串）

data.name

string

收件人姓名（未识别时为空字符串）

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{ "code": 0, "msg": "成功", "data": { "original": "张三 138****1234 上海市浦东新区张江镇科苑路88号 201203", "province": "上海市", "city": "上海市", "district": "浦东新区", "street": "张江镇", "detail": "科苑路88号", "zipcode": "201203", "phone": "138****1234", "name": "张三" }, "request_id": "kx8n9q2a1b3c4d5e6f7g", "tips": "极数本源 · https://apizero.cn" }