智能快递查询

支持国内外2000多家快递公司跟踪服务，输入运单编号自动识别物流公司，即时返回物流轨迹。仅需一次对接，打通快递物流公司轨迹数据，直连快递公司支持顺丰、中通、韵达、京东、圆通、申通、极兔等主流快递公司。日查询次数过百万，满足企业大规模物流数据查询需求，接口稳定可靠。【量大优惠】可联系客服定制。

100次

10000次

100000次

500000次

1000000次

¥0.01 （约0.0001元/次）

新用户一分购

立即申请

免费测试

产品介绍

API文档

错误码参照

调试工具

接口地址：https://api.tanshuapi.com/api/exp/v1/index

返回格式：json

请求方式：不限

请求示例：https://api.tanshuapi.com/api/exp/v1/index?key=&com=&no=78792812069699

接口备注：

请求参数说明:

名称	必填	类型	说明
key	是	string	个人中心查看
com	否	string	快递公司编码,从子接口”快递公司查询“ 中查到快递公司列表如不知道快递公司可以为空,此时将自动识别快递单号所属公司，建议传入准确的公司编码。
no	是	string	快递单号
phone	否	int	收/寄件人手机号后四位，顺丰、跨越快递需填写本字段。

返回参数说明:

名称	类型	说明
company	string	快递公司名称
status_detail	string	当前物流状态 1 揽件 2 运输中 3 派送中 4 已签收 5 包裹异常/签收失败 10 退回
datetime	string	物流时间
remark	string	物流详细信息
com_phone	string	快递公司联系方式
com_url	string	快递公司网址
take_time	string	物流轨迹耗时
courier_phone	string	快递员联系方式
status_desc	string	签收状态文案

JSON返回示例:

                {
    "code": 1,
    "msg": "操作成功",
    "data": {
        "company": "中通快递", //快递公司名称
        "com": "zto", //快递公司编码
        "no": "78792812069699", //快递单号
        "com_phone": "95311", //快递公司联系方式
        "com_url": "www.zto.cn", //快递公司网址
        "take_time": "4天17小时8分", //物流轨迹耗时
        "courier_phone": "18223636061", //快递员联系方式
        "status_desc": "已签收", //签收状态文案
        "status_detail": 4, //当前节点状态 1 揽件 2 运输中 3 派送中 4 已签收 5 包裹异常/签收失败 10 退回
        "list": [
            {
                "datetime": "2024-05-04 15:58:17", //物流时间
                "remark": "【东莞市】已签收，签收人凭取货码签收，如有疑问请电联：0769-33550361/ 0769-33550361。感谢使用中通快递，期待再次为您服务！" //节点详细信息
            },
            {
                "datetime": "2024-05-01 18:44:23",
                "remark": "【东莞市】 快件已在 丰巢 的【信鸿誉庭2栋架空层丰巢柜】暂放，【取件地址：信鸿誉庭2栋架空层丰巢柜】，请及时取件。如有疑问请联系业务员：18223636061，代理点电话：18223636061，投诉电话：13059109000"
            },
            {
                "datetime": "2024-05-01 15:17:14",
                "remark": "【东莞市】东莞樟木头 的业务员【李杨,18223636061】正在为您派件（95720为中通快递员外呼专属号码，请放心接听，如有问题可联系网点:0769-33550361,投诉电话:13059109000）"
            },
            {
                "datetime": "2024-05-01 14:30:07",
                "remark": "【东莞市】 快件已到达 东莞樟木头"
            },
            {
                "datetime": "2024-05-01 09:51:15",
                "remark": "【东莞市】 快件已发往 东莞樟木头"
            },
            {
                "datetime": "2024-05-01 09:38:06",
                "remark": "【东莞市】 快件已到达 东莞转运中心"
            },
            {
                "datetime": "2024-04-30 05:16:09",
                "remark": "【南宁市】 快件已发往 东莞转运中心"
            },
            {
                "datetime": "2024-04-30 05:13:53",
                "remark": "【南宁市】 快件已到达 南宁转运中心"
            },
            {
                "datetime": "2024-04-29 22:50:05",
                "remark": "【南宁市】 快件已发往 南宁转运中心"
            },
            {
                "datetime": "2024-04-29 22:49:35",
                "remark": "【南宁市】 南宁建工城（0771-7711792,19163802501）项目部-漫花（19163802501） 已揽收"
            }
        ]
    }
}

接口地址：https://api.tanshuapi.com/api/exp/v1/com

返回格式：json

请求方式：不限

请求示例：https://api.tanshuapi.com/api/exp/v1/com?key=

接口备注：

请求参数说明:

名称	必填	类型	说明
key	是	string	个人中心查看

返回参数说明:

名称	类型	说明
company	string	快递公司
com	string	快递类型码
url	string	网址
phone	string	联系方式
initial	string	首字母
img_url	string	图片logo

JSON返回示例:

                {
    "code": 1,
    "msg": "操作成功",
    "data": [
        {
            "company": "百世汇通",
            "com": "htky",
            "url": "www.800bestex.com",
            "phone": "95320",
            "initial": "B",
            "img_url": "http://gtms02.alicdn.com/tps/i2/TB1sj1uKFXXXXb.XVXXqxFJVFXX-100-100.png"
        },
        {
            "company": "EMS",
            "com": "ems",
            "url": "www.ems.com.cn",
            "phone": "11183",
            "initial": "E",
            "img_url": "http://gtms02.alicdn.com/tps/i2/TB18XmAKFXXXXaiXVXXqxFJVFXX-100-100.png"
        },
        {
            "company": "丰网速运",
            "com": "fengwang",
            "url": "www.fwx-network.com",
            "phone": "9533855",
            "initial": "F",
            "img_url": ""
        },
        {
            "company": "国通快递",
            "com": "gto",
            "url": "www.gto365.com",
            "phone": "95327",
            "initial": "G",
            "img_url": "https://gw.alicdn.com/tfs/TB11qgsmRfH8KJjy1XbXXbLdXXa-100-100.jpg"
        },
        {
            "company": "京东快递",
            "com": "jd",
            "url": "www.jdl.cn",
            "phone": "950616",
            "initial": "J",
            "img_url": ""
        },
        {
            "company": "快捷快递",
            "com": "fast",
            "url": "www.kjkd.com",
            "phone": "4008333666",
            "initial": "K",
            "img_url": "http://gtms02.alicdn.com/tps/i2/TB12wWWKFXXXXctXXXXqxFJVFXX-100-100.png"
        },
        {
            "company": "申通快递",
            "com": "sto",
            "url": "www.sto.cn",
            "phone": "95543",
            "initial": "S",
            "img_url": "https://img.alicdn.com/tfs/TB1VWfwaxv1gK0jSZFFXXb0sXXa-100-100.png"
        },
        {
            "company": "顺丰速运",
            "com": "sf",
            "url": "www.sf-express.com",
            "phone": "95338",
            "initial": "S",
            "img_url": "http://gtms02.alicdn.com/tps/i2/TB1SvuZKFXXXXbjXXXXqxFJVFXX-100-100.png"
        },
        {
            "company": "天天快递",
            "com": "ttkdex",
            "url": "www.ttkdex.com",
            "phone": "4001888888",
            "initial": "T",
            "img_url": "http://gtms01.alicdn.com/tps/i1/TB1Y29BKFXXXXXAXVXXqxFJVFXX-100-100.png"
        },
        {
            "company": "优速快递",
            "com": "uc",
            "url": "www.uce.cn",
            "phone": "95349",
            "initial": "Y",
            "img_url": "http://gtms03.alicdn.com/tps/i3/TB124mQKFXXXXXrXpXXqxFJVFXX-100-100.png"
        },
        {
            "company": "圆通速递",
            "com": "yto",
            "url": "www.ytoexpress.com",
            "phone": "95554",
            "initial": "Y",
            "img_url": "http://gtms03.alicdn.com/tps/i3/TB1E49DKFXXXXcSXFXXqxFJVFXX-100-100.png"
        },
        {
            "company": "韵达快递",
            "com": "yunda",
            "url": "www.yundaex.com",
            "phone": "95546",
            "initial": "Y",
            "img_url": "http://gtms01.alicdn.com/tps/i1/TB16iy9KVXXXXaXapXXqxFJVFXX-100-100.png"
        },
        {
            "company": "壹米滴答",
            "com": "yimidida",
            "url": "www.yimidida.com",
            "phone": "95058",
            "initial": "Y",
            "img_url": ""
        },
        {
            "company": "宅急送",
            "com": "zjs",
            "url": "www.zjs.com.cn",
            "phone": "4006789000",
            "initial": "Z",
            "img_url": "http://gtms01.alicdn.com/tps/i1/TB1SnayKFXXXXa7XVXXqxFJVFXX-100-100.png"
        },
        {
            "company": "中国邮政",
            "com": "post",
            "url": "www.chinapost.com.cn",
            "phone": "11185",
            "initial": "Z",
            "img_url": "http://gtms04.alicdn.com/tps/i4/TB1T0qDKFXXXXbpXpXXqxFJVFXX-100-100.png"
        },
        {
            "company": "中通快递",
            "com": "zto",
            "url": "www.zto.cn",
            "phone": "95311",
            "initial": "Z",
            "img_url": "https://img.alicdn.com/tfs/TB1vOZTpxz1gK0jSZSgXXavwpXa-100-100.png"
        }
    ]
}

接口地址：https://api.tanshuapi.com/api/exp/v1/auto_com

返回格式：json

请求方式：不限

请求示例：https://api.tanshuapi.com/api/exp/v1/auto_com?key=&no=78792812069699

接口备注：

请求参数说明:

名称	必填	类型	说明
key	是	string	个人中心查看
no	是	string	快递单号

返回参数说明:

名称	类型	说明
com	string	快递公司编码
company	string	快递公司
com_phone	string	快递公司联系方式
com_url	string	快递公司网址

JSON返回示例:

                {
    "code": 1,
    "msg": "操作成功",
    "data": {
        "com": "zto", //快递公司编码
        "company": "中通快递", //快递公司
        "com_phone": "95311", //快递公司联系方式
        "com_url": "www.zto.cn" //快递公司网址
    }
}

接口地址：https://api.tanshuapi.com/api/exp/v2/index

返回格式：json

请求方式：不限

请求示例：https://api.tanshuapi.com/api/exp/v2/index?key=&com=&no=JT3088459689824

接口备注：

请求参数说明:

名称	必填	类型	说明
key	是	string	个人中心查看
com	否	string	快递公司编码,从子接口”快递公司查询“ 中查到快递公司列表如不知道快递公司可以为空,此时将自动识别快递单号所属公司，建议传入准确的公司编码。
no	是	string	快递单号
phone	否	int	收/寄件人手机号后四位，顺丰、跨越快递需填写本字段，建议填写寄件人手机号。

返回参数说明:

名称	类型	说明
company	string	快递公司名称
com_phone	string	快递公司联系方式
com_url	string	快递公司网址
tracks_count	string	物流轨迹条数
take_time	string	物流轨迹耗时
courier_phone	string	快递员联系方式
status_desc	string	签收状态文案
status_detail	string	当前物流状态 1 揽件 2 运输中 3 派送中 4 已签收 5 包裹异常 6 清关 7 转投
sub_status_detail	string	当前物流高级状态，详细编码：https://www.tanshuapi.com/news/detail-159
list.time	string	物流节点时间
list.context	string	物流节点轨迹描述
list.sub_status_detail	string	物流节点子状态
list.area_name	string	物流节点地区
list.area_code	string	物流节点地区行政编码
list.area_location	string	物流节点地区经纬度，坐标系:GCJ-02

JSON返回示例:

                {
    "code": 1,
    "msg": "操作成功",
    "data": {
        "company": "极兔快递",
        "com": "jtexpress",
        "no": "JT3088459689824",
        "com_phone": "400-820-1666",
        "com_url": "www.jtexpress.com",
        "com_logo": "https://img.tanshuapi.com/exp_logo/jtexpress.png",
        "tracks_count": "9",
        "take_time": "1天8小时20分",
        "courier_phone": "19705060162",
        "status_desc": "已签收",
        "status_detail": 4,
        "sub_status_detail": 403,
        "list": [
            {
                "time": "2024-09-03 22:18:21",
                "context": "包裹已签收！签收人是【本人签收】，如有问题请联系常信雷：19705060162，投诉电话：025-52664296",
                "sub_status_detail": 403,
                "area_code": "CN320100000000",
                "area_name": "江苏省,南京市",
                "area_location": "118.796877,32.060255"
            },
            {
                "time": "2024-09-03 17:40:54",
                "context": "【南京玄武月苑网点】的兔兔快递员 常信雷 19705060162 正在派件（可放心接听952300专属热线），投诉电话：025-52664296。今天的兔兔，怀揣包裹，卯足干劲，为您“加吉”派送中",
                "sub_status_detail": 3,
                "area_code": "CN320100000000",
                "area_name": "江苏省,南京市",
                "area_location": "118.796877,32.060255"
            },
            {
                "time": "2024-09-03 17:39:54",
                "context": "快件到达【南京玄武月苑网点】",
                "sub_status_detail": 2,
                "area_code": "CN320100000000",
                "area_name": "江苏省,南京市",
                "area_location": "118.796877,32.060255"
            },
            {
                "time": "2024-09-03 10:29:23",
                "context": "快件离开【南京转运中心】已发往【南京玄武月苑网点】",
                "sub_status_detail": 2,
                "area_code": "CN320100000000",
                "area_name": "江苏省,南京市",
                "area_location": "118.796877,32.060255"
            },
            {
                "time": "2024-09-03 10:11:48",
                "context": "快件到达【南京转运中心】",
                "sub_status_detail": 2,
                "area_code": "CN320100000000",
                "area_name": "江苏省,南京市",
                "area_location": "118.796877,32.060255"
            },
            {
                "time": "2024-09-02 22:42:37",
                "context": "快件离开【武汉转运中心】已发往【南京转运中心】",
                "sub_status_detail": 2,
                "area_code": "CN420100000000",
                "area_name": "湖北省,武汉市",
                "area_location": "114.305393,30.593099"
            },
            {
                "time": "2024-09-02 22:37:38",
                "context": "快件到达【武汉转运中心】",
                "sub_status_detail": 2,
                "area_code": "CN420100000000",
                "area_name": "湖北省,武汉市",
                "area_location": "114.305393,30.593099"
            },
            {
                "time": "2024-09-02 13:58:17",
                "context": "快件离开【汉川北斗七星网点】已发往【武汉转运中心】",
                "sub_status_detail": 2,
                "area_code": "CN420900000000",
                "area_name": "湖北省,孝感市",
                "area_location": "113.916902,30.924568"
            },
            {
                "time": "2024-09-02 13:58:07",
                "context": "【汉川北斗七星网点】的胡颖北斗七星（13429810209）已取件，投诉电话：0712-2101334",
                "sub_status_detail": 102,
                "area_code": "CN420900000000",
                "area_name": "湖北省,孝感市",
                "area_location": "113.916902,30.924568"
            }
        ]
    }
}

服务级错误码参照:

错误码	说明
206801	快递公司识别失败
206802	运单号错误
206803	查询失败
206804	暂无物流轨迹信息(计次)

系统级错误码参照:

错误码	说明
10001	错误的请求KEY
10002	该KEY无请求权限
10003	KEY过期
10004	未知的请求源
10005	被禁止的IP
10006	被禁止的KEY
10007	请求超过次数限制
10008	接口维护

智能快递查询

https://api.tanshuapi.com/api/exp/v1/index

填写参数

参数名	参数值	说明
com		快递公司编码,从子接口”快递公司查询“ 中查到快递公司列表如不知道快递公司可以为空,此时将自动识别快递单号所属公司，建议传入准确的公司编码。
no		快递单号
phone		收/寄件人手机号后四位，顺丰、跨越快递需填写本字段。

https://api.tanshuapi.com/api/exp/v1/com

填写参数

参数名	参数值	说明

https://api.tanshuapi.com/api/exp/v1/auto_com

填写参数

参数名	参数值	说明
no		快递单号

https://api.tanshuapi.com/api/exp/v2/index

填写参数

参数名	参数值	说明
com		快递公司编码,从子接口”快递公司查询“ 中查到快递公司列表如不知道快递公司可以为空,此时将自动识别快递单号所属公司，建议传入准确的公司编码。
no		快递单号
phone		收/寄件人手机号后四位，顺丰、跨越快递需填写本字段，建议填写寄件人手机号。