# 火车票查询 **请求方式:** 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=上海 ```