# Google API: Search Google Flights > 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. Unofficial. Not affiliated with or endorsed by Google. - Page: https://fous.com/methods/google.com/search-flights - Method: `google.com/search_flights`, version 1 - Website: google.com - Returns: airlines, flight numbers, airports, local departure and arrival times, travel time, stops, layovers, price, CO2, flight 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 | |---|---|---|---|---| | `sort` | string | no | `"cheapest"` | Order by lowest price or Google Flights best ranking, for example cheapest. One of "cheapest", "best". Default "cheapest". | | `cabin` | string | no | `"economy"` | Cabin class, for example business. One of "economy", "premium_economy", "business", "first". Default "economy". | | `stops` | string | no | `"any"` | Stop limit, for example nonstop. One of "any", "nonstop", "one_stop_or_fewer". Default "any". | | `adults` | integer | no | `1` | Number of adults, for example 2. Default 1. | | `origin` | string | yes | `"New York"` | Departure city or airport, for example New York. | | `currency` | string | no | `"USD"` | Three-letter fare currency, for example USD. Default "USD". | | `destination` | string | yes | `"Los Angeles"` | Arrival city or airport, for example Los Angeles. | | `max_results` | integer | no | `20` | Maximum number of flights to return, for example 20. Default 20. | | `return_date` | string | no | | Return departure date (YYYY-MM-DD), for example 2026-10-27. Leave empty for one-way. | | `departure_date` | string | yes | `"2026-11-17"` | Outbound departure date (YYYY-MM-DD), for example 2026-10-20. | ## Output From a run on Nov 2, 2026, shortened. Its input: ```json { "sort": "cheapest", "cabin": "economy", "stops": "any", "adults": 1, "origin": "New York", "currency": "USD", "destination": "Los Angeles", "max_results": 20, "departure_date": "2026-11-17" } ``` Its output: ```json { "flights": [ { "price": 184, "stops": 1, "co2_kg": 276, "airlines": [ "Frontier" ], "currency": "USD", "page_link": "https://www.google.com/travel/flights?tfs=CBwQAhp9EgoyMDI2LTExLTE3IiAKA0xHQRIKMjAyNi0xMS0xNxoDQVRMKgJGOTIEMzI4NyIgCgNBVEwSCjIwMjYtMTEtMTcaA0xBWCoCRjkyBDQzMTVqBwgBEgNKRktqBwgBEgNMR0FqBwgBEgNFV1JyBwgBEgNMQVhyBwgBEgNCVVJAAUgBcAGYAQI&hl=en&gl=US&curr=USD", "travel_time": "8 h 49 min", "arrival_time": "2026-11-17T12:19:00-08:00", "departure_time": "2026-11-17T06:30:00-05:00", "flight_numbers": [ "F9 3287", "F9 4315" ], "travel_minutes": 529, "layover_airports": [ "Hartsfield-Jackson Atlanta International Airport (ATL)" ], "arrival_airport_code": "LAX", "arrival_airport_name": "Los Angeles International Airport", "departure_airport_code": "LGA", "departure_airport_name": "LaGuardia Airport" }, { "price": 184, "stops": 1, "co2_kg": 286, "airlines": [ "Frontier" ], "currency": "USD", "page_link": "https://www.google.com/travel/flights?tfs=CBwQAhp9EgoyMDI2LTExLTE3IiAKA0VXUhIKMjAyNi0xMS0xNxoDQVRMKgJGOTIENDYwMSIgCgNBVEwSCjIwMjYtMTEtMTcaA0xBWCoCRjkyBDMyMTVqBwgBEgNKRktqBwgBEgNMR0FqBwgBEgNFV1JyBwgBEgNMQVhyBwgBEgNCVVJAAUgBcAGYAQI&hl=en&gl=US&curr=USD", "travel_time": "9 h 18 min", "arrival_time": "2026-11-17T17:53:00-08:00", "departure_time": "2026-11-17T11:35:00-05:00", "flight_numbers": [ "F9 4601", "F9 3215" ], "travel_minutes": 558, "layover_airports": [ "Hartsfield-Jackson Atlanta International Airport (ATL)" ], "arrival_airport_code": "LAX", "arrival_airport_name": "Los Angeles International Airport", "departure_airport_code": "EWR", "departure_airport_name": "Newark Liberty International Airport" }, { "price": 209, "stops": 1, "co2_kg": 384, "airlines": [ "Delta" ], "currency": "USD", "page_link": "https://www.google.com/travel/flights?tfs=CBwQAhp8EgoyMDI2LTExLTE3Ih8KA0pGSxIKMjAyNi0xMS0xNxoDU0xDKgJETDIDODkyIiAKA1NMQxIKMjAyNi0xMS0xNxoDQlVSKgJETDIEMzA3M2oHCAESA0pGS2oHCAESA0xHQWoHCAESA0VXUnIHCAESA0xBWHIHCAESA0JVUkABSAFwAZgBAg&hl=en&gl=US&curr=USD", "travel_time": "8 h 19 min", "arrival_time": "2026-11-17T11:59:00-08:00", "departure_time": "2026-11-17T06:40:00-05:00", "flight_numbers": [ "DL 892", "DL 3073" ], "travel_minutes": 499, "layover_airports": [ "Salt Lake City International Airport (SLC)" ], "arrival_airport_code": "BUR", "arrival_airport_name": "Hollywood Burbank Airport", "departure_airport_code": "JFK", "departure_airport_name": "John F. Kennedy International Airport" } ], "search_link": "https://www.google.com/travel/flights?tfs=CBwQAho5EgoyMDI2LTExLTE3agcIARIDSkZLagcIARIDTEdBagcIARIDRVdScgcIARIDTEFYcgcIARIDQlVSQAFIAXABmAEC&hl=en&gl=US&curr=USD" } ``` ## 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":"google.com/search_flights","input":{"sort":"cheapest","cabin":"economy","stops":"any","adults":1,"origin":"New York","currency":"USD","destination":"Los Angeles","max_results":20,"departure_date":"2026-11-17"}}' ``` 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 the cheapest nonstop flights from Chicago to Denver on 2026-03-14 for 2 adults, prices in USD - What are my business class options from London Heathrow to Singapore departing June 5, 2026 and returning June 19? Show the round-trip fares and layovers. - Check Google Flights for one-way economy flights Toronto to Vancouver on 2026-08-02, priced in CAD, max 10 results - I need flights SFO to Tokyo Narita leaving 2026-11-10 back 2026-11-24, one stop or fewer, best ranked, with CO2 emissions per flight - Pull up Google flight results for 3 adults Madrid to Rome on 2026-05-21, premium economy, prices in EUR, with departure and arrival times ## Input schema ```json { "type": "object", "required": [ "origin", "destination", "departure_date" ], "properties": { "sort": { "enum": [ "cheapest", "best" ], "type": "string", "default": "cheapest", "description": "Order by lowest price or Google Flights best ranking, for example cheapest." }, "cabin": { "enum": [ "economy", "premium_economy", "business", "first" ], "type": "string", "default": "economy", "description": "Cabin class, for example business." }, "stops": { "enum": [ "any", "nonstop", "one_stop_or_fewer" ], "type": "string", "default": "any", "description": "Stop limit, for example nonstop." }, "adults": { "type": "integer", "default": 1, "maximum": 9, "minimum": 1, "description": "Number of adults, for example 2." }, "origin": { "type": "string", "minLength": 2, "description": "Departure city or airport, for example New York." }, "currency": { "type": "string", "default": "USD", "description": "Three-letter fare currency, for example USD." }, "destination": { "type": "string", "minLength": 2, "description": "Arrival city or airport, for example Los Angeles." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of flights to return, for example 20." }, "return_date": { "type": "string", "description": "Return departure date (YYYY-MM-DD), for example 2026-10-27. Leave empty for one-way." }, "departure_date": { "type": "string", "description": "Outbound departure date (YYYY-MM-DD), for example 2026-10-20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "search_link", "flights" ], "properties": { "flights": { "type": "array", "items": { "type": "object", "required": [ "airlines", "flight_numbers", "departure_airport_name", "departure_airport_code", "arrival_airport_name", "arrival_airport_code", "departure_time", "arrival_time", "travel_time", "travel_minutes", "stops", "layover_airports", "price", "currency", "co2_kg", "page_link" ], "properties": { "price": { "type": "number", "description": "Displayed fare." }, "stops": { "type": "integer", "description": "Number of stops." }, "co2_kg": { "type": [ "number", "null" ], "description": "Emissions in kilograms, if displayed." }, "airlines": { "type": "array", "items": { "type": "string" }, "description": "Airlines operating the itinerary." }, "currency": { "type": "string", "description": "Fare currency code." }, "page_link": { "type": "string", "description": "Google Flights link for this flight selection." }, "travel_time": { "type": [ "string", "null" ], "description": "Elapsed travel time." }, "arrival_time": { "type": "string", "description": "Local arrival time with UTC offset." }, "departure_time": { "type": "string", "description": "Local departure time with UTC offset." }, "flight_numbers": { "type": "array", "items": { "type": "string" }, "description": "Flight numbers of all segments." }, "travel_minutes": { "type": [ "integer", "null" ], "description": "Elapsed travel time in minutes." }, "layover_airports": { "type": "array", "items": { "type": "string" }, "description": "Layover airports, including their names and codes." }, "arrival_airport_code": { "type": [ "string", "null" ], "description": "Final arrival airport code." }, "arrival_airport_name": { "type": [ "string", "null" ], "description": "Final arrival airport name." }, "departure_airport_code": { "type": [ "string", "null" ], "description": "First departure airport code." }, "departure_airport_name": { "type": [ "string", "null" ], "description": "First departure airport name." } }, "additionalProperties": false }, "description": "Flight options." }, "search_link": { "type": "string", "description": "Link to the full Google Flights search." } }, "additionalProperties": false } ``` ## See more - [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. - [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: Search Google Hotels](https://fous.com/methods/google.com/search-hotels.md): Finds places to stay in a city or area for given dates on Google Hotels, with nightly and total prices, hotel class, guest ratings, amenities, address and cheapest booking site. Optional filters for price, stars and rating; vacation rentals are left out. Prices and availability can change. - [Google API: Get directions](https://fous.com/methods/google.com/get-directions.md): Gets up to three Google Maps routes between two places, with distances, travel times and step-by-step directions. - [Google API: Get company ads](https://fous.com/methods/adstransparency.google.com/get-company-ads.md): Finds a verified advertiser in the Google Ads Transparency Center by company name or website domain and returns its Google ads with dates, regions, previews and ad pages. Counts may be approximate; regions and media previews are read for the first 40 ads. - [Google API: Get hotel reviews from Google Hotels](https://fous.com/methods/google.com/get-hotel-reviews.md): Finds a hotel on Google Hotels by name and city and returns its guest reviews in the chosen order, its Google rating and review count, and topic ratings averaged from the returned reviews that rate each topic. - [Google API: Search patents](https://fous.com/methods/patents.google.com/search-patents.md): Finds Google Patents about an invention. Optional filters: inventor, assignee, country, filing date and publication stage. Legal status is the site's estimate. - [Google API: Search places](https://fous.com/methods/google.com/search-places.md): Finds businesses and places near a location on Google Maps, in Google Maps order, with rating, hours, contact details and links when shown. - [All Google methods](https://fous.com/methods/google.com.md)