邮政编码查询API接口文档 GET / POST 生活服务

支持按省份、城市、区县、邮政编码、区号进行查询。数据覆盖全国各省市县区。

请求 GET / POST返回 application/json0.5 积分 / 次上线 2026-09-24 14:57:41

支持按省份、城市、区县、邮政编码、区号进行查询。数据覆盖全国各省市县区。

0.5 积分 / 次调用次数: 3正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=zipcode
方法
GET / POST
分类
生活服务
计费
0.5 积分 / 次
KEY
KEY 必填
调用
3
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者
—

邮政编码查询接口信息

接口地址：
https://api.souxiaocha.com/apis/gateway?api=zipcode
请求方式：
GET / POST
返回格式：
application/json

调用统计

3总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=zipcode

apikey=你的API密钥&keyword=请填写keyword&type=请填写type&page=请填写page&limit=请填写limit

GET 参数放在查询字符串中。参数值请替换为实际有效值。

邮政编码查询请求参数

参数名类型必填说明示例
keywordstring是查询关键词
typestring否查询类型：all(综合)、province(省份)、city(城市)、area(区县)、post_code(邮编)、area_code(区号)。默认all
pageinteger否页码，默认1
limitinteger否每页条数，默认50，最大100
返回示例
{"success":true,"data":[{"province":"浙江省","city":"杭州市","area":"上城区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"下城区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"临安市","post_code":"311300","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"余杭区","post_code":"311100","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"富阳区","post_code":"311400","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"建德市","post_code":"311600","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"拱墅区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"杭州市","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"桐庐县","post_code":"311500","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"江干区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"淳安县","post_code":"311700","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"滨江区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"萧山区","post_code":"311200","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"西湖区","post_code":"310000","area_code":"0571"}],"pagination":{"page":1,"limit":50,"total":14,"total_pages":1},"generated_at":"2026-08-12 10:14:17"}

详细文档

邮政编码查询 API 接口文档

接口描述

支持按省份、城市、区县、邮政编码、区号进行查询。数据覆盖全国各省市县区。

功能特性

  • 支持按省份、城市、区县、邮政编码、区号进行查询。数据覆盖全国各省市县区。
  • 返回 JSON 结构化数据，便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=zipcode

请求方式

GET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）

鉴权方式

调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：

  • URL 参数：key=SK-你的密钥
  • 或请求头：X-API-Key: SK-你的密钥

请求参数

参数名 类型 必填 描述
keyword string 是 查询关键词
type string 否 查询类型：all(综合)、province(省份)、city(城市)、area(区县)、post_code(邮编)、area_code(区号)。默认all
page integer 否 页码，默认1
limit integer 否 每页条数，默认50，最大100

请求参数 (JSON格式)

[
  {"name": "keyword", "type": "string", "required": true, "description": "查询关键词"},
  {"name": "type", "type": "string", "required": false, "description": "查询类型：all(综合)、province(省份)、city(城市)、area(区县)、post_code(邮编)、area_code(区号)。默认all"},
  {"name": "page", "type": "integer", "required": false, "description": "页码，默认1"},
  {"name": "limit", "type": "integer", "required": false, "description": "每页条数，默认50，最大100"}
]

响应格式

JSON 格式响应

成功返回示例：

{"success":true,"data":[{"province":"浙江省","city":"杭州市","area":"上城区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"下城区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"临安市","post_code":"311300","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"余杭区","post_code":"311100","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"富阳区","post_code":"311400","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"建德市","post_code":"311600","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"拱墅区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"杭州市","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"桐庐县","post_code":"311500","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"江干区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"淳安县","post_code":"311700","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"滨江区","post_code":"310000","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"萧山区","post_code":"311200","area_code":"0571"},{"province":"浙江省","city":"杭州市","area":"西湖区","post_code":"310000","area_code":"0571"}],"pagination":{"page":1,"limit":50,"total":14,"total_pages":1},"generated_at":"2026-08-12 10:14:17"}

失败返回示例：

{"success":false,"error":"missing_keyword","message":"请提供查询关键词（keyword）"}

返回参数说明

参数名 类型 说明
data[].province string 省份
data[].city string 城市
data[].area string 区/县
data[].post_code string 邮政编码
data[].area_code string 区号
pagination.page integer 当前页码
pagination.limit integer 每页条数
pagination.total integer 总记录数
pagination.total_pages integer 总页数

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=zipcode?key=SK-你的密钥&keyword=%E6%9D%AD%E5%B7%9E"

错误响应

上游业务级错误：

code msg 描述
400 missing_keyword 缺少keyword参数

平台级错误（errcode）：11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcode 与 msg 判断。

注意事项

  • 本接口为平台代理的聚合数据服务，数据与稳定性以上游服务为准
  • 涉及命理、测算类内容（如有）仅供娱乐参考，不构成任何现实建议
  • 请合理控制调用频率，避免高频恶意调用触发风控
  • 密钥请妥善保管，勿在公开代码或前端页面中暴露

开发时间

2026-09-24