# 火车票查询

**请求方式:** GET|POST

**接口地址:** https://api.hk0.cc/api/train

**接口描述:** 火车票余票查询:输入出发地、到达地、日期,实时返回 12306 全部车次的时刻、历时、座位余票和参考票价。

参数:
- from:必填,出发地。支持城市名(北京,自动合并北京/北京南/北京西等全部车站)、车站名(北京南)、拼音(shanghaihongqiao)或电报码(VNP)。
- to:必填,到达地,规则同 from。
- date:可选,出发日期 YYYY-MM-DD 或 YYYYMMDD,默认明天。仅支持预售期内(今天起 15 天),也接受 today / tomorrow。
- type:可选,车次类型过滤,逗号分隔。G=高铁(含城际 C)、D=动车、Z=直达、T=特快、K=快速。
- only_available:可选,传 1 只返回有余票的车次。
- train:可选,只查指定车次,如 G1 或 G1,G3。
- depart_from / depart_to:可选,出发时段过滤,格式 HH:MM,如 08:00 至 12:00。
- sort:可选,排序方式:start(默认,出发时间)、arrive(到达时间)、duration(历时最短)、price(最低票价)。
- limit:可选,返回条数上限,默认 200,最大 500。
- fresh:可选,传 1 跳过 60 秒缓存强制重新取数。

也支持查询车站字典:action=stations&keyword=上海虹桥(或拼音 hongqiao),返回车站名、电报码与拼音;keyword 留空返回支持的城市分组列表。

返回:
- data.trains[]:train(车次)、kind(高铁/动车/直达/特快/快速/普快)、from / to(上车站、下车站)、start / arrive(发到时刻)、arrive_day(0 当天到达,1 次日到达)、duration(历时)、duration_min(历时分钟)、can_buy(是否可购票)、seats(各座位类型余票,有=20 张以上)、prices(参考票价,元)、price_min(最低票价)。
- data.summary:按车次类型的数量统计、有余票车次数、本次实际请求的车站组合数与命中缓存数。
- data.presale:当前可查询的日期区间。

说明:数据实时取自 12306 余票接口,缓存 60 秒;票价按查询区段返回,仅供参考,以 12306 下单页为准。

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| from | from | query | 必传 | 北京 | — | 必填,出发地:城市名 / 车站名 / 拼音 / 电报码 |
| to | to | query | 必传 | 上海 | — | 必填,到达地:城市名 / 车站名 / 拼音 / 电报码 |
| date | date | query | 可选 | 2026-11-20 | — | 可选,出发日期 YYYY-MM-DD,默认明天,仅限预售期 15 天内 |
| type | type | query | 可选 | G,D | — | 可选,车次类型过滤,G/D/Z/T/K,逗号分隔 |
| only_available | only_available | query | 可选 | 1 | 0 | 可选,传 1 只返回有余票车次 |
| train | train | query | 可选 | G1,G3 | — | 可选,只查指定车次,逗号分隔 |
| depart_from | depart_from | query | 可选 | 08:00 | — | 可选,出发时段起,HH:MM |
| depart_to | depart_to | query | 可选 | 12:00 | — | 可选,出发时段止,HH:MM |
| sort | sort | query | 可选 | duration | start | 可选,排序:start / arrive / duration / price |
| limit | limit | query | 可选 | 20 | 200 | 可选,返回条数上限,默认 200,最大 500 |
| fresh | fresh | query | 可选 | 1 | 0 | 可选,传 1 跳过 60 秒缓存 |
| action | action | query | 可选 | stations | — | 可选,传 stations 查询车站字典 |
| keyword | keyword | query | 可选 | 上海虹桥 | — | action=stations 时使用,车站名或拼音,留空返回城市列表 |

## 返回示例

```json
https://api.hk0.cc/api/train?from=北京&to=上海
```