<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 快递查询PRO

比免费版多自动识别，并多查韵达、京东、EMS 等 2000+ 家快递（免费版只有申通、圆通、顺丰、中通、百世、极兔）。

可不传 com，系统按单号识别公司。顺丰、中通须传手机号后 4 位。返回字段与免费版相同。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `express-pro` |
| 接口名称 | 快递查询PRO |
| 接口地址 | `https://v1.apizero.cn/api/express-pro` |
| 请求方法 | `GET` |
| 分类 | 生活服务 |
| 提供方 | 极数本源 |
| 计费模式 | 按次付费 · 点数包 · 月套餐 |
| QPS 限制 | 2 req/s |
| 登录免费额度 | 5 次 |
| 匿名每日额度 | 2 次 |

## 1.1 会员每日额度

| 会员档位 | 每日免费 | QPS |
| --- | --- | --- |
| 黄金会员 | 30 次/日 | QPS 10 |
| 企业会员 | 200 次/日 | QPS 120 |

## 2. 认证

比免费版多自动识别，以及韵达、京东、EMS 等更多公司。按次 ¥0.011 或 1 点/次；也可买月卡（¥9.9 / ¥29.9 / ¥99.9）。顺丰/中通必须传 phone。六家常用快递可用免费版 /api/express。

获取 API Key：登录 https://apizero.cn/account/keys 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `number` | `string` | 是 | 快递单号（8-40 位字母或数字） | `YT7460266600081` |
| `com` | `string` | 否 | 快递公司编码（如 sf/yto/zto/sto/yunda/jt/jd/ems）；缺省由系统自动识别 | `yunda` |
| `phone` | `string` | 否 | 手机号后 4 位数字（仅 顺丰 / 中通 必填） | `1234` |

## 5. 请求示例

### cURL

```bash
curl "https://v1.apizero.cn/api/express-pro?number=YT7460266600081&com=yunda&phone=1234&key=YOUR_API_KEY"
```

### Python

```python
import requests

resp = requests.get(
    "https://v1.apizero.cn/api/express-pro",
    params={
    "number": "YT7460266600081",
    "com": "yunda",
    "phone": "1234",
    "key": "YOUR_API_KEY",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())
```

### JavaScript

```javascript
const params = new URLSearchParams({
  "number": "YT7460266600081",
  "com": "yunda",
  "phone": "1234",
  "key": "YOUR_API_KEY",
});

const res = await fetch(`https://v1.apizero.cn/api/express-pro?${params}`);
const data = await res.json();
console.log(data);
```

### Go

```go
package main

import (
        "fmt"
        "io"
        "net/http"
        "net/url"
)

func main() {
        q := url.Values{}
	q.Set("number", "YT7460266600081")
	q.Set("com", "yunda")
	q.Set("phone", "1234")
	q.Set("key", "YOUR_API_KEY")
        resp, err := http.Get("https://v1.apizero.cn/api/express-pro?" + q.Encode())
        if err != nil { panic(err) }
        defer resp.Body.Close()
        body, _ := io.ReadAll(resp.Body)
        fmt.Println(string(body))
}
```

### PHP

```php
<?php
$query = http_build_query([
  "number" => "YT7460266600081",
  "com" => "yunda",
  "phone" => "1234",
  "key" => "YOUR_API_KEY",
]);
$res = file_get_contents("https://v1.apizero.cn/api/express-pro?" . $query);
echo $res;
```

## 6. 响应字段

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `number` | `string` | 快递单号（与请求一致或系统规范化后的） |
| `com` | `string` | 快递公司编码（如 sf、yto） |
| `com_name` | `string` | 快递公司中文名称 |
| `state` | `number` | 状态码：0=未查到 / 1=已揽收 / 2=在途 / 3=已签收 / 4=问题件 / 其他 |
| `status` | `string` | 状态英文标识（如 EMPTY、PROCESSING、DELIVERED） |
| `status_desc` | `string` | 状态中文描述（人类可读，建议直接显示给用户） |
| `trace_count` | `number` | 物流轨迹条数（traces 数组长度） |
| `traces` | `array` | 物流轨迹列表（按时间倒序，最新在前） |
| `traces[].time` | `string` | 该轨迹的时间（YYYY-MM-DD HH:mm:ss） |
| `traces[].content` | `string` | 该轨迹的中文描述（如「已揽收，离开广州转运中心」） |
| `tips` | `string` | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |

## 7. 响应示例

```json
{
  "code": 0,
  "msg": "成功",
  "data": {
    "number": "EA000123456CN:0000",
    "com": "ems",
    "com_name": "EMS",
    "state": 3,
    "status": "SIGNED",
    "status_desc": "已签收",
    "trace_count": 14,
    "traces": [
      {
        "time": "2026-03-06 11:31:58",
        "content": "您的快件已取走【示例市示例驿站A区1号店】，如有疑问请电联快递员【电话:13800138000】，揽投部【电话:0571-00000000】，投诉电话【电话:13900139000】。中国邮政服务热线11183。"
      },
      {
        "time": "2026-03-03 17:29:26",
        "content": "您的快件已派送至【示例市示例驿站A区1号店】，自提点电话:13700137000，请您凭取件码领取快件，如有疑问请电联快递员【电话:13800138000】，揽投部（电话0571-00000000），投诉电话（电话13900139000）。中国邮政服务热线11183。"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn",
  "request_id": "req_demo_ems_0001"
}
```

## 8. 错误码

| 业务码 | HTTP | 说明 |
| --- | --- | --- |
| — | — | 无 |

## 9. 变更日志

- **1.1.0** (2026-08-30): 按次价改为 ¥0.011（上游 ¥0.0099，加价约 12%）
上架月卡：¥9.9 / 900 次 / QPS 20，¥29.9 / 2700 次 / QPS 30，¥99.9 / 9000 次 / QPS 40
- **1.0.0** (2026-08-28): 上架：比免费版多自动识别，覆盖韵达、京东、EMS 等更多公司