GETflight-query
Flight Information Lookup
Search for flight information and check flight status by entering your departure city, destination, and travel date.
Documentation
API Introduction
This API supports querying detailed itinerary information for domestic and international flights by origin, destination, and departure date. The returned data includes airline code, flight number, three-letter airport codes for departure and arrival, specific departure and arrival times, flight duration, number of transfers, and reference ticket prices.
Use Cases
- Travel Management Systems: Provide real-time flight schedule retrieval and price comparison functions for corporate employees.
- OTA Platform Integration: Supplement basic flight data, display direct or connecting flight options, and estimated travel time.
- Itinerary Planning Applications: Help users plan travel based on departure/arrival times and airport information.
Request and Response Details
- Request Method: GET
- Core Parameters: Requires origin, destination, and departure date.
- Response Structure:
flightInfo: An array of flight lists.airline/airlineName: Two-letter airline code and Chinese name.departure/arrival: Three-letter airport codes for departure/arrival (e.g., PEK, PVG).departureTime/arrivalTime: Scheduled departure and arrival times.transferNum: Number of transfers, 0 indicates a direct flight.ticketPrice: Reference ticket price (numeric type).segments: For connecting flights, includes detailed operating information for each segment.
Integration Recommendations
- Caching Strategy: Flight schedules are relatively stable; it is recommended to short-term cache query results for the same route and date to reduce API call costs.
- Price Disclaimer: The
ticketPricereturned by the API is for reference only. Actual transaction prices should be based on real-time ticketing by airlines or agents. - Error Handling: Please check the
reasonfield in the response to ensure user-friendly prompts are provided when no results are found or parameters are incorrect.
Integration Examples
Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.
Request Example
{}Response Example
{
"reason": "成功",
"result": {
"orderid": "JH818250617094826CZLKl",
"flightInfo": [
{
"airline": "CA",
"airlineName": "中国**航空公司",
"flightNo": "CA0953 | CA0916",
"isCodeShare": false,
"departure": "PEK",
"departureName": "首都国际机场",
"departureDate": "2025-06-18",
"departureTime": "09:05",
"arrivalDate": "2025-06-18",
"arrivalTime": "17:05",
"arrival": "PVG",
"arrivalName": "浦东国际机场",
"duration": "08h00m",
"transferNum": 2,
"ticketPrice": 15063,
"segments": [
{
"airline": "CA",
"flightNo": "CA0953",
"isCodeShare": false,
"opAirline": "CA",
"opFlightNo": "CA0953",
"equipment": "738",
"departure": "PEK",
"departureDate": "2025-06-18",
"departureTime": "09:05",
"arrival": "FUK",
"arrivalDate": "2025-06-18",
"arrivalTime": "14:10",
"flightTime": "04h05m",
"airlineName": "中国**航空公司",
"departureName": "首都国际机场",
"arrivalName": "福冈机场"
},
{
"airline": "CA",
"flightNo": "CA0916",
"isCodeShare": false,
"opAirline": "CA",
"opFlightNo": "CA0916",
"equipment": "321",
"departure": "FUK",
"departureDate": "2025-06-18",
"departureTime": "15:55",
"arrival": "PVG",
"arrivalDate": "2025-06-18",
"arrivalTime": "17:05",
"flightTime": "02h10m",
"airlineName": "中国**航空公司",
"departureName": "福冈机场",
"arrivalName": "浦东国际机场"
}
]
}
]
},
"error_code": 0
}Request Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Sample |
|---|---|---|
| type | string | object |
| properties | object | {...} |
Response Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Sample |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.reason | object | {...} |
| properties.reason.type | string | string |
| properties.reason.example | string | 成功 |
| properties.result | object | {...} |
| properties.result.type | string |
