# Trip.com API: Search flights

> Finds priced flights between two cities or airports on Trip.com for the chosen dates, cheapest first; round trips pair each outbound flight with its available returns.

Unofficial. Not affiliated with or endorsed by Trip.com.

- Page: https://fous.com/methods/trip.com/search-flights
- Method: `trip.com/search_flights`, version 1
- Website: trip.com
- Returns: airlines, flight numbers, airports, local times, durations, stops, price per traveller, currency, Trip.com link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `cabin` | string | no |  | Seat class, e.g. business. One of "economy", "premium_economy", "business", "first". Default "economy". |
| `adults` | integer | no |  | Number of adult travellers, e.g. 2. Default 1. |
| `origin` | string | yes | `"Singapore"` | Departure city or airport, e.g. Singapore or SIN. |
| `currency` | string | no |  | Three-letter display currency, e.g. USD. Default "USD". |
| `destination` | string | yes | `"Seoul"` | Arrival city or airport, e.g. Seoul or ICN. |
| `max_results` | integer | no |  | Maximum priced flight options, e.g. 20. Default 20. |
| `return_date` | string | no |  | Return date for a round trip (YYYY-MM-DD), e.g. 2026-10-22. |
| `nonstop_only` | boolean | no |  | Only show flights without stops, e.g. true. Default false. |
| `departure_date` | string | yes | `"2026-11-12"` | Departure date (YYYY-MM-DD), e.g. 2026-10-15. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "origin": "Singapore",
  "destination": "Seoul",
  "departure_date": "2026-11-12"
}
```

Its output:

```json
{
  "flights": [
    {
      "currency": "USD",
      "return_stops": 0,
      "trip_com_url": "https://www.trip.com/flights/showfarefirst?dcity=sin&acity=sel&ddate=2026-10-15&triptype=ow&class=y&quantity=1&nonstoponly=off&locale=en-XX&curr=USD",
      "outbound_stops": 1,
      "return_airlines": [],
      "outbound_airlines": [
        "Jeju Air"
      ],
      "return_travel_time": null,
      "price_per_traveller": 179,
      "return_arrival_time": null,
      "outbound_travel_time": "30 h 50 min",
      "return_stop_airports": [],
      "outbound_arrival_time": "2026-10-16T08:15:00+09:00",
      "return_departure_time": null,
      "return_flight_numbers": [],
      "outbound_stop_airports": [
        "Gimhae International Airport (PUS)"
      ],
      "outbound_departure_time": "2026-10-15T00:25:00+08:00",
      "outbound_flight_numbers": [
        "7C2662",
        "7C904"
      ],
      "return_travel_time_minutes": null,
      "return_arrival_airport_code": null,
      "return_arrival_airport_name": null,
      "outbound_travel_time_minutes": 1850,
      "outbound_arrival_airport_code": "GMP",
      "outbound_arrival_airport_name": "Gimpo International Airport",
      "return_departure_airport_code": null,
      "return_departure_airport_name": null,
      "outbound_departure_airport_code": "SIN",
      "outbound_departure_airport_name": "Singapore Changi Airport"
    },
    {
      "currency": "USD",
      "return_stops": 0,
      "trip_com_url": "https://www.trip.com/flights/showfarefirst?dcity=sin&acity=sel&ddate=2026-10-15&triptype=ow&class=y&quantity=1&nonstoponly=off&locale=en-XX&curr=USD",
      "outbound_stops": 1,
      "return_airlines": [],
      "outbound_airlines": [
        "VietJet Air"
      ],
      "return_travel_time": null,
      "price_per_traveller": 188,
      "return_arrival_time": null,
      "outbound_travel_time": "17 h 45 min",
      "return_stop_airports": [],
      "outbound_arrival_time": "2026-10-16T06:00:00+09:00",
      "return_departure_time": null,
      "return_flight_numbers": [],
      "outbound_stop_airports": [
        "Danang International Airport (DAD)"
      ],
      "outbound_departure_time": "2026-10-15T11:15:00+08:00",
      "outbound_flight_numbers": [
        "VJ970",
        "VJ878"
      ],
      "return_travel_time_minutes": null,
      "return_arrival_airport_code": null,
      "return_arrival_airport_name": null,
      "outbound_travel_time_minutes": 1065,
      "outbound_arrival_airport_code": "ICN",
      "outbound_arrival_airport_name": "Incheon International Airport",
      "return_departure_airport_code": null,
      "return_departure_airport_name": null,
      "outbound_departure_airport_code": "SIN",
      "outbound_departure_airport_name": "Singapore Changi Airport"
    },
    {
      "currency": "USD",
      "return_stops": 0,
      "trip_com_url": "https://www.trip.com/flights/showfarefirst?dcity=sin&acity=sel&ddate=2026-10-15&triptype=ow&class=y&quantity=1&nonstoponly=off&locale=en-XX&curr=USD",
      "outbound_stops": 2,
      "return_airlines": [],
      "outbound_airlines": [
        "VietJet Air"
      ],
      "return_travel_time": null,
      "price_per_traveller": 221,
      "return_arrival_time": null,
      "outbound_travel_time": "28 h 40 min",
      "return_stop_airports": [],
      "outbound_arrival_time": "2026-10-17T01:10:00+09:00",
      "return_departure_time": null,
      "return_flight_numbers": [],
      "outbound_stop_airports": [
        "Tan Son Nhat International Airport (SGN)",
        "Phu Quoc International Airport (PQC)"
      ],
      "outbound_departure_time": "2026-10-15T19:30:00+08:00",
      "outbound_flight_numbers": [
        "VJ812",
        "VJ337",
        "VJ978"
      ],
      "return_travel_time_minutes": null,
      "return_arrival_airport_code": null,
      "return_arrival_airport_name": null,
      "outbound_travel_time_minutes": 1720,
      "outbound_arrival_airport_code": "ICN",
      "outbound_arrival_airport_name": "Incheon International Airport",
      "return_departure_airport_code": null,
      "return_departure_airport_name": null,
      "outbound_departure_airport_code": "SIN",
      "outbound_departure_airport_name": "Singapore Changi Airport"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"trip.com/search_flights","input":{"origin":"Singapore","destination":"Seoul","departure_date":"2026-11-12"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find me the cheapest flights from Bangkok to Tokyo Narita on 2026-03-12, economy, one adult, prices in USD.
- On Trip.com, search round-trip business class flights from London to Dubai leaving November 4 and coming back November 11 for 2 adults, show prices in GBP.
- I need nonstop options only from SFO to JFK on 2026-07-02 for 3 people — list airlines, flight numbers, times and price per person.
- Use trip.com to compare premium economy fares Sydney to Singapore, departing 2026-12-18, returning 2027-01-05, top 10 results in AUD.
- What are the cheapest flights from Frankfurt to Seoul ICN on May 20? Show stops, durations, and prices in EUR, max 30 options.

## Input schema

```json
{
  "type": "object",
  "required": [
    "origin",
    "destination",
    "departure_date"
  ],
  "properties": {
    "cabin": {
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "type": "string",
      "default": "economy",
      "description": "Seat class, e.g. business."
    },
    "adults": {
      "type": "integer",
      "default": 1,
      "maximum": 9,
      "minimum": 1,
      "description": "Number of adult travellers, e.g. 2."
    },
    "origin": {
      "type": "string",
      "minLength": 2,
      "description": "Departure city or airport, e.g. Singapore or SIN."
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "maxLength": 3,
      "minLength": 3,
      "description": "Three-letter display currency, e.g. USD."
    },
    "destination": {
      "type": "string",
      "minLength": 2,
      "description": "Arrival city or airport, e.g. Seoul or ICN."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum priced flight options, e.g. 20."
    },
    "return_date": {
      "type": "string",
      "description": "Return date for a round trip (YYYY-MM-DD), e.g. 2026-10-22."
    },
    "nonstop_only": {
      "type": "boolean",
      "default": false,
      "description": "Only show flights without stops, e.g. true."
    },
    "departure_date": {
      "type": "string",
      "description": "Departure date (YYYY-MM-DD), e.g. 2026-10-15."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "flights"
  ],
  "properties": {
    "flights": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "outbound_airlines",
          "outbound_flight_numbers",
          "outbound_departure_airport_name",
          "outbound_departure_airport_code",
          "outbound_arrival_airport_name",
          "outbound_arrival_airport_code",
          "outbound_departure_time",
          "outbound_arrival_time",
          "outbound_travel_time",
          "outbound_travel_time_minutes",
          "outbound_stops",
          "outbound_stop_airports",
          "return_airlines",
          "return_flight_numbers",
          "return_departure_airport_name",
          "return_departure_airport_code",
          "return_arrival_airport_name",
          "return_arrival_airport_code",
          "return_departure_time",
          "return_arrival_time",
          "return_travel_time",
          "return_travel_time_minutes",
          "return_stops",
          "return_stop_airports",
          "price_per_traveller",
          "currency",
          "trip_com_url"
        ],
        "properties": {
          "currency": {
            "type": "string"
          },
          "return_stops": {
            "type": "integer"
          },
          "trip_com_url": {
            "type": "string",
            "format": "uri"
          },
          "outbound_stops": {
            "type": "integer"
          },
          "return_airlines": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "outbound_airlines": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "return_travel_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Journey duration, e.g. 7 h 25 min."
          },
          "price_per_traveller": {
            "type": "number",
            "description": "Displayed fare per adult including taxes."
          },
          "return_arrival_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Local arrival time, ISO 8601 with UTC offset."
          },
          "outbound_travel_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Journey duration, e.g. 7 h 25 min."
          },
          "return_stop_airports": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Connecting airports as name (code)."
          },
          "outbound_arrival_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Local arrival time, ISO 8601 with UTC offset."
          },
          "return_departure_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Local departure time, ISO 8601 with UTC offset."
          },
          "return_flight_numbers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "outbound_stop_airports": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Connecting airports as name (code)."
          },
          "outbound_departure_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Local departure time, ISO 8601 with UTC offset."
          },
          "outbound_flight_numbers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "return_travel_time_minutes": {
            "type": [
              "integer",
              "null"
            ],
            "x-fous-developer": true
          },
          "return_arrival_airport_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "return_arrival_airport_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "outbound_travel_time_minutes": {
            "type": [
              "integer",
              "null"
            ],
            "x-fous-developer": true
          },
          "outbound_arrival_airport_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "outbound_arrival_airport_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "return_departure_airport_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "return_departure_airport_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "outbound_departure_airport_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "outbound_departure_airport_name": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Trip.com API: Search hotels](https://fous.com/methods/trip.com/search-hotels.md): Finds hotels in a city on Trip.com for given dates, with prices, guest ratings, reviews and booking links. Only the initial public listing is read, so large limits may return fewer hotels.
- [Expedia API: Search flights](https://fous.com/methods/expedia.com/search-flights.md): Finds Expedia flights between cities or airports on selected dates, with per-traveler USD prices. Round trips combine outbound and return choices; for round trips only the cheapest outbound choices are paired with their returns.
- [Google API: Search Google Flights](https://fous.com/methods/google.com/search-flights.md): Finds Google Flights options for a route and date with prices, local times, stops and emissions. Round-trip searches list outbound choices with their displayed round-trip fares.
- [Google API: List cheap flight destinations](https://fous.com/methods/google.com/list-cheap-destinations.md): Lists cheap round-trip destinations from a city on Google Travel Explore, sorted by fare, optionally within a region, travel month, trip length and nonstop only. Links search Google Flights for the shown dates.
- [Google API: Get cheapest flight dates in a month](https://fous.com/methods/google.com/get-cheapest-dates.md): Finds the lowest Google Flights fare for each departure date in a month between two places, for one-way trips or a fixed trip length, with the cheapest option and any price insight shown.
- [FlixBus API: Search bus trips](https://fous.com/methods/flixbus.com/search-bus-trips.md): Finds dated FlixBus trip options between two cities, with stops, local times, availability and displayed per-person prices, including partner operators on some routes.
- [Ryanair API: List cheapest fares](https://fous.com/methods/ryanair.com/list-cheapest-fares.md): Lists the cheapest one-way Ryanair fare to each destination from a city or airport during a date range, sorted by price.
- [Expedia API: Search hotels](https://fous.com/methods/expedia.com/search-hotels.md): Finds Expedia hotels in a destination for given dates, with public USD prices, reviews, property class, refund status and links. Nightly prices are per room; totals include all requested rooms, taxes and fees.
- [All Trip.com methods](https://fous.com/methods/trip.com.md)
