火车票余票信息查询 - 接口盒子 - 免费API-免费接口-站长工具-www.apihz.cn

接口调用地址

线路类型一 [普通集群负载-IP接口]

说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。

线路类型二 [普通集群负载-域名接口]

https://cn.apihz.cn/api/12306/api.php

测速复制

说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。

线路类型三 [VIP集群负载-VIP线路接口]

https://vip.apihz.cn/api/12306/api.php

测速复制

说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。

请求示例

[GET]请求示例：(请登录后使用自己的KEY独享频次)

复制参数复制全部

https://cn.apihz.cn/api/12306/api.php?id=88888888&key=88888888&add=绵阳&end=上海&y=2025&m=6&d=30&ck=

[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)

请求参数说明

注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。

名称	参数	必填	说明
开发者ID	id	是	用户中心的数字ID，例：id=10000000
开发者KEY	key	是	用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2
出发站点	add	是	出发地或出发车站名称，例：add=绵阳
目的站点	end	是	目的地或目的车站名称，例：end=上海
出发日期-年	y	是	不超过预售时间，一般为15天内，出发日期-年，例：y=2025
出发日期-月	m	是	不超过预售时间，一般为15天内，出发日期-月，例：m=6
出发日期-日	d	是	不超过预售时间，一般为15天内，出发日期-日，例：d=30
cookie	ck	否	不传该参数则使用平台提供的cookie，如果多次查询失败可能是平台cookie失效，可传自己的cookie，参照图片教程：https://down.erguanmingmin.com/api/img/12306ck.png，浏览器访问12306官网，打开调试模式，然后任意查询火车票，找到该链接https://kyfw.12306.cn/otn/leftTicket/queryU，取cookie里面的JSESSIONID值，只需传等号后面的字符串即可。ck=0EC5DA0C04CB6793F9C293EBF28B485B
动态秘钥	dkey	否	开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371
用户IP	uip	否	接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。

返回参数说明

名称	参数	说明
状态码	code	200成功，400错误。普通用户采用接口本地线路调用，成功率无保障。彩钻和炫钻，焱钻用户采用本地+代理双模式调用，成功率较高。查询成功后的信息有60秒缓存期。
提示信息	msg	提示信息
数据集	datas	数据集
车组编号	datas.train_number	车组编号
车次编号	datas.train_order	车次编号
出发站点索引	datas.depart_index	出发站点索引
目的站点索引	datas.arrive_index	目的站点索引
出发站点名称	datas.depart_name	出发站点名称
目的站点名称	datas.arrive_name	目的站点名称
出发站点归属市	datas.depart_city	出发站点归属市
目的站点归属市	datas.arrive_city	目的站点归属市
出发站点代码	datas.depart_code	出发站点代码
目的站点代码	datas.arrive_code	目的站点代码
出发时间	datas.depart_time	出发时间
目的时间	datas.arrive_time	目的时间
总计耗时	datas.duration	总计耗时
座位参数	datas.seatcode	座位参数
出发日期	datas.date	出发日期
票量数据集	datas.seats	票量数据集
座位等级	datas.seats.type	座位等级
座位余票	datas.seats.stock	座位余票，-1代表有票，票量充足。0代表无票。大于0代表余票数量，票量紧张。

返回数据示例

示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
    "code": 200,
    "td": "本地模式",
    "datas": [{
        "train_number": "G3286",
        "train_order": "76000G32860A",
        "depart_index": "04",
        "arrive_index": "24",
        "depart_name": "绵阳",
        "arrive_name": "上海虹桥",
        "depart_city": "绵阳",
        "arrive_city": "上海",
        "depart_code": "MYW",
        "arrive_code": "AOH",
        "depart_time": "08:32",
        "arrive_time": "19:42",
        "duration": "11:10",
        "seatcode": "9MOO",
        "date": "2025-12-15",
        "seats": [{
            "type": "商务座(特等座)",
            "stock": 0
        }, {
            "type": "一等座",
            "stock": 4
        }, {
            "type": "二等座(二等包座)",
            "stock": -1
        }, {
            "type": "高级软卧",
            "stock": 0
        }, {
            "type": "软卧(动卧一等卧)",
            "stock": 0
        }, {
            "type": "硬卧(二等卧)",
            "stock": 0
        }, {
            "type": "软座",
            "stock": 0
        }, {
            "type": "硬座",
            "stock": 0
        }, {
            "type": "无座",
            "stock": 0
        }, {
            "type": "优选一等座",
            "stock": 0
        }]
    }, {
        "train_number": "G3290",
        "train_order": "77000G32900E",
        "depart_index": "06",
        "arrive_index": "30",
        "depart_name": "绵阳",
        "arrive_name": "上海虹桥",
        "depart_city": "绵阳",
        "arrive_city": "上海",
        "depart_code": "MYW",
        "arrive_code": "AOH",
        "depart_time": "11:22",
        "arrive_time": "22:47",
        "duration": "11:25",
        "seatcode": "9MOO",
        "date": "2025-12-15",
        "seats": [{
            "type": "商务座(特等座)",
            "stock": 2
        }, {
            "type": "一等座",
            "stock": -1
        }, {
            "type": "二等座(二等包座)",
            "stock": -1
        }, {
            "type": "高级软卧",
            "stock": 0
        }, {
            "type": "软卧(动卧一等卧)",
            "stock": 0
        }, {
            "type": "硬卧(二等卧)",
            "stock": 0
        }, {
            "type": "软座",
            "stock": 0
        }, {
            "type": "硬座",
            "stock": 0
        }, {
            "type": "无座",
            "stock": 0
        }, {
            "type": "优选一等座",
            "stock": 0
        }]
    }, {
        "train_number": "G1976",
        "train_order": "77000G19760O",
        "depart_index": "06",
        "arrive_index": "26",
        "depart_name": "绵阳",
        "arrive_name": "上海虹桥",
        "depart_city": "绵阳",
        "arrive_city": "上海",
        "depart_code": "MYW",
        "arrive_code": "AOH",
        "depart_time": "11:46",
        "arrive_time": "22:32",
        "duration": "10:46",
        "seatcode": "9MOO",
        "date": "2025-12-15",
        "seats": [{
            "type": "商务座(特等座)",
            "stock": 2
        }, {
            "type": "一等座",
            "stock": 9
        }, {
            "type": "二等座(二等包座)",
            "stock": -1
        }, {
            "type": "高级软卧",
            "stock": 0
        }, {
            "type": "软卧(动卧一等卧)",
            "stock": 0
        }, {
            "type": "硬卧(二等卧)",
            "stock": 0
        }, {
            "type": "软座",
            "stock": 0
        }, {
            "type": "硬座",
            "stock": 0
        }, {
            "type": "无座",
            "stock": 0
        }, {
            "type": "优选一等座",
            "stock": 0
        }]
    }, {
        "train_number": "D978",
        "train_order": "770000D97800",
        "depart_index": "04",
        "arrive_index": "11",
        "depart_name": "绵阳",
        "arrive_name": "上海虹桥",
        "depart_city": "绵阳",
        "arrive_city": "上海",
        "depart_code": "MYW",
        "arrive_code": "AOH",
        "depart_time": "20:27",
        "arrive_time": "08:58",
        "duration": "12:31",
        "seatcode": "OFO",
        "date": "2025-12-15",
        "seats": [{
            "type": "商务座(特等座)",
            "stock": 0
        }, {
            "type": "一等座",
            "stock": 0
        }, {
            "type": "二等座(二等包座)",
            "stock": 5
        }, {
            "type": "高级软卧",
            "stock": 0
        }, {
            "type": "软卧(动卧一等卧)",
            "stock": -1
        }, {
            "type": "硬卧(二等卧)",
            "stock": 0
        }, {
            "type": "软座",
            "stock": 0
        }, {
            "type": "硬座",
            "stock": 0
        }, {
            "type": "无座",
            "stock": 0
        }, {
            "type": "优选一等座",
            "stock": 0
        }]
    }, {
        "train_number": "K284",
        "train_order": "760000K2840I",
        "depart_index": "03",
        "arrive_index": "25",
        "depart_name": "绵阳",
        "arrive_name": "上海",
        "depart_city": "绵阳",
        "arrive_city": "上海",
        "depart_code": "MYW",
        "arrive_code": "SHH",
        "depart_time": "20:28",
        "arrive_time": "06:53",
        "duration": "34:25",
        "seatcode": "1431",
        "date": "2025-12-15",
        "seats": [{
            "type": "商务座(特等座)",
            "stock": 0
        }, {
            "type": "一等座",
            "stock": 0
        }, {
            "type": "二等座(二等包座)",
            "stock": 0
        }, {
            "type": "高级软卧",
            "stock": 0
        }, {
            "type": "软卧(动卧一等卧)",
            "stock": 16
        }, {
            "type": "硬卧(二等卧)",
            "stock": -1
        }, {
            "type": "软座",
            "stock": 0
        }, {
            "type": "硬座",
            "stock": -1
        }, {
            "type": "无座",
            "stock": -1
        }, {
            "type": "优选一等座",
            "stock": 0
        }]
    }, {
        "train_number": "K352",
        "train_order": "760000K3520V",
        "depart_index": "03",
        "arrive_index": "25",
        "depart_name": "绵阳",
        "arrive_name": "上海松江",
        "depart_city": "绵阳",
        "arrive_city": "上海",
        "depart_code": "MYW",
        "arrive_code": "IMH",
        "depart_time": "21:23",
        "arrive_time": "07:50",
        "duration": "34:27",
        "seatcode": "3411",
        "date": "2025-12-15",
        "seats": [{
            "type": "商务座(特等座)",
            "stock": 0
        }, {
            "type": "一等座",
            "stock": 0
        }, {
            "type": "二等座(二等包座)",
            "stock": 0
        }, {
            "type": "高级软卧",
            "stock": 0
        }, {
            "type": "软卧(动卧一等卧)",
            "stock": 5
        }, {
            "type": "硬卧(二等卧)",
            "stock": -1
        }, {
            "type": "软座",
            "stock": 0
        }, {
            "type": "硬座",
            "stock": -1
        }, {
            "type": "无座",
            "stock": 0
        }, {
            "type": "优选一等座",
            "stock": 0
        }]
    }]
}

更新记录

接口信息

12306-火车票余票信息查询

查询指定日期，出发地到目的地火车票余票等信息。普通用户采用接口本地线路调用，成功率无保障。彩钻和炫钻，焱钻用户采用本地+代理双模式调用，成功率较高。调用该接口后可根据该接口返回的信息继续调用查询票价接口和车次全程站点及停留时间查询接口。 [2026-03-26 20:48:55]

使用协议：接口盒子提供的所有服务不得用于任何违法行为。接口盒子提供的信息，使用者应当自行判断准确性，适用性。使用者所造成的一切后果责任，损失等，由使用者自行承担。使用者产品所需资质应由使用者自身办理，接口盒子仅提供接口技术，不对使用者产品所需资质负责。从使用接口盒子的服务起默认遵守此协议。

调用限制

调用权限	非定制接口直接使用
单价/次	免费[无上限]
单日[所有用户之和]	999999999
1分钟并发[所有用户之和]	5000
1小时并发[所有用户之和]	999999999
频次限制[注册用户]	10次/分钟\|每日无上限
频次限制[钻石会员]	最高8000+次/分钟\|每日无上限
频次限制[定制频次]	联系我们定制

调用方法

请求方式	GET/POST
返回格式	JSON
编码格式	UTF-8

调用信息

浏览量	加载中
今日总计调用	加载中
昨日总计调用	加载中
历史总计调用	加载中
今日排名	加载中
总排名	加载中

12306-相关接口

接口测速诊断

12306-火车票余票信息查询

火车票余票-换乘方案查询

火车票公示票价查询

火车车次经停站点查询

火车票余票票价查询