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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Cabin optional
cabin Seat class, e.g. business.
economy (default)
One of
economy,premium_economy,business,first.- Adults optional
adults Number of adult travellers, e.g. 2.
1 (default)
Whole number from 1 to 9.
- Origin, required
origin Departure city or airport, e.g. Singapore or SIN.
Singapore
2 characters or more.
- Currency optional
currency Three-letter display currency, e.g. USD.
USD (default)
Exactly 3 characters.
- Destination, required
destination Arrival city or airport, e.g. Seoul or ICN.
Seoul
2 characters or more.
- Max Results optional
max_results Maximum priced flight options, e.g. 20.
20 (default)
Whole number from 1 to 50.
- Return Date optional
return_date Return date for a round trip (YYYY-MM-DD), e.g. 2026-10-22.
Not set
- Nonstop Only optional
nonstop_only Only show flights without stops, e.g. true.
false (default)
True or false.
- Departure Date, required
departure_date Departure date (YYYY-MM-DD), e.g. 2026-10-15.
2026-11-12
Input as JSON
{ "origin": "Singapore", "destination": "Seoul", "departure_date": "2026-11-12"}Output
{ "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" } ]}Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "trip.com/search_flights" , "input": { "origin": "Singapore", "destination": "Seoul", "departure_date": "2026-11-12" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "trip.com/search_flights" , "input": { "origin": "Singapore", "destination": "Seoul", "departure_date": "2026-11-12" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run trip.com/search_flights# with {"origin":"Singapore","destination":"Seoul","departure_date":"2026-11-12"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
trip.com/search_flights- Returns
- airlines, flight numbers, airports, local times, durations, stops, price per traveller, currency, Trip.com link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method trip.com/search_flights with the inputs above.
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.
See more
All Trip.com methodsFinds 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.
trip.com/search_hotelsFinds 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.
expedia.com/search_flightsFinds 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.com/search_flightsLists 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.com/list_cheap_destinationsFinds 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.
google.com/get_cheapest_datesFinds dated FlixBus trip options between two cities, with stops, local times, availability and displayed per-person prices, including partner operators on some routes.
flixbus.com/search_bus_tripsLists the cheapest one-way Ryanair fare to each destination from a city or airport during a date range, sorted by price.
ryanair.com/list_cheapest_faresFinds 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.
expedia.com/search_hotels