POSTPublictrain-schedule-query

Train Schedule and Ticket Availability Query

Query nationwide train numbers, departure/arrival times, seat prices, and real-time ticket availability snapshots based on origin, destination, and travel date. Ideal for travel planning and ticket information display.

Usage Cost

10 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

API Capabilities

This API provides a nationwide train schedule and ticket availability query service. Users input origin station, destination station, and a specified date to retrieve a list of matching train numbers, departure and arrival times, travel duration, and price and availability snapshot information for various seat types (e.g., Second Class, First Class).

Request and Response

Request Parameters: Requires start (origin station), end (destination station), date (travel date, format YYYY-MM-DD), and an optional ishigh parameter to filter for high-speed rail (G/D trains) only.
Response Results: Returns a list of train information. Each record includes trainno (train number), departuretime (departure time), arrivaltime (arrival time), price (price for each seat type), and num (ticket quantity/status for each seat type).

Use Cases

Travel Planning Applications: Integrate into travel, calendar, or itinerary management tools to provide users with convenient train schedule queries.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "start": "北京南",
  "end": "上海虹桥",
  "ishigh": "1",
  "date": "2026-07-20"
}

Response Example

{
  "code": 200,
  "msg": "成功",
  "taskNo": "example",
  "data": {
    "date": "2026-07-20",
    "start": "北京南",
    "end": "上海虹桥",
    "list": [
      {
        "trainno": "G1",
        "departuretime": "07:00",
        "arrivaltime": "11:30",
        "ze": {
          "price": "553.0",
          "num": "有"
        }
      }
    ]
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
start	string	北京南
end	string	上海虹桥
ishigh	string	1
date	string	2026-07-20

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	number	200
msg	string	成功
taskNo	string	example
data	object	{...}
data.date	string	2026-07-20
data.start	string	北京南
data.end	string	上海虹桥

curl --request POST \ --url 'https://openapi.toolkk.com/v1/train-schedule-query' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "start": "北京南",\n "end": "上海虹桥",\n "ishigh": "1",\n "date": "2026-07-20"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/train-schedule-query" payload = { "start": "北京南", "end": "上海虹桥", "ishigh": "1", "date": "2026-07-20" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/train-schedule-query" payload := []byte("{\n \"start\": \"北京南\",\n \"end\": \"上海虹桥\",\n \"ishigh\": \"1\",\n \"date\": \"2026-07-20\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"start\": \"北京南\",\n \"end\": \"上海虹桥\",\n \"ishigh\": \"1\",\n \"date\": \"2026-07-20\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/train-schedule-query")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/train-schedule-query'; $payload = "{\n \"start\": \"北京南\",\n \"end\": \"上海虹桥\",\n \"ishigh\": \"1\",\n \"date\": \"2026-07-20\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

Train Schedule and Ticket Availability Query

Try it online

Documentation

API Capabilities

Request and Response

Use Cases

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Usage Instructions and Limitations

Shell Example

Python Example

Go Example

Java Example

PHP Example