覆盖全国 8,000+ 个高铁、动车、普速列车车次的时刻表与经停站信息,支持按车次号、出发站、到达站组合查询,返回发车时间、到站时间、行程耗时、全部经停站信息,适用于出行规划、交通导航、票务系统等场景。
火车票时刻 API 通过标准 HTTP GET 请求返回 JSON 格式的列车时刻数据。支持按车次号精确查询,也可按出发站与到达站组合检索。返回字段涵盖车次号、列车类型、始发站、终到站、发车时间、到站时间、运行时长、全部经停站数组等信息,经停站包含到达和发车时间、停靠时长。接口全程 HTTPS 加密传输,支持高并发调用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥,在控制台「应用管理」中创建应用后获取。 |
| train_no | string | 否 | 车次号,如 G1、D301、K101,与 from+to 二选一。 |
| from | string | 否 | 出发站名称,如「北京南」,与 train_no 二选一。 |
| to | string | 否 | 到达站名称,如「上海虹桥」,配合 from 使用。 |
| date | string | 否 | 查询日期,格式 yyyy-MM-dd,默认当天。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示请求成功,其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.train_no | string | 车次号。 |
| data.type | string | 列车类型:G=高铁、D=动车、C=城际、K=快速、T=特快、Z=直达。 |
| data.from_station | string | 出发站名称。 |
| data.to_station | string | 到达站名称。 |
| data.depart_time | string | 发车时间,格式 HH:mm。 |
| data.arrive_time | string | 到站时间,格式 HH:mm。 |
| data.duration | string | 运行时长,如「4小时28分」。 |
| data.stops | array | 经停站数组,每项含 station(站名)、arrive(到达时间)、depart(发车时间)、stop_time(停靠时长)。 |
| data.update_time | string | 数据更新时间,格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"train_no": "G1",
"type": "G",
"from_station": "北京南",
"to_station": "上海虹桥",
"depart_time": "09:00",
"arrive_time": "13:28",
"duration": "4小时28分",
"stops": [
{ "station": "北京南", "arrive": "--", "depart": "09:00", "stop_time": "--" },
{ "station": "济南西", "arrive": "10:32", "depart": "10:34", "stop_time": "2分" },
{ "station": "南京南", "arrive": "12:18", "depart": "12:20", "stop_time": "2分" },
{ "station": "上海虹桥", "arrive": "13:28", "depart": "--", "stop_time": "--" }
],
"update_time": "2026-07-25 08:00:00"
}
}