Google API: List cheap flight destinations
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.
Unofficial. Not affiliated with or endorsed by Google.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Month optional
month Travel month as YYYY-MM, for example 2026-11; blank searches the next six months.
(default)
- Origin, required
origin Departure city or airport, for example Chicago.
Chicago
- Region optional
region Destination country or continent, for example Europe; blank means anywhere.
(default)
- Currency optional
currency Currency code, for example USD.
USD (default)
- Max Results optional
max_results Maximum destinations, for example 30.
30 (default)
Whole number from 1 to 100.
- Trip Length optional
trip_length Trip length, for example weekend.
one_week (default)
One of
weekend,one_week,two_weeks.- Nonstop Only optional
nonstop_only Only show nonstop flights, for example false.
false (default)
True or false.
Input as JSON
{ "origin": "Chicago"}Output
{ "destinations": [ { "stops": 0, "airline": "Frontier", "country": "United States", "currency": "USD", "return_date": "2026-11-07", "departure_date": "2026-10-29", "flight_duration": "3 hr 10 min", "destination_city": "Miami", "round_trip_price": 106, "google_flights_link": "https://www.google.com/travel/flights?q=Flights+from+Chicago+to+Miami+on+2026-10-29+through+2026-11-07&curr=USD" , "destination_image_link": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSrG9OUnELSUuakgLFhP8lNaCon9j4U7QzgO7J1NWTOnxKY2kx9cuLRFjwf3pGLPQ2qUcuX2TVXirLt85v2ArUDY1SwKOlHSUyAlpWJg4U" }, { "stops": 0, "airline": "Frontier", "country": "United States", "currency": "USD", "return_date": "2026-11-07", "departure_date": "2026-10-29", "flight_duration": "3 hr 10 min", "destination_city": "Fort Lauderdale", "round_trip_price": 106, "google_flights_link": "https://www.google.com/travel/flights?q=Flights+from+Chicago+to+Fort+Lauderdale+on+2026-10-29+through+2026-11-07&curr=USD" , "destination_image_link": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ2tVG3-tYrOMKlhXOfCR2kPLmJ0jRGqs2wQxZrGPw3LFJu6nYbPgrF0Ii72zFG4aHY-o7VD2l8oyT793jaEpa4HUN6OFn9R4AMiwRRpkA" }, { "stops": 0, "airline": "Frontier", "country": "United States", "currency": "USD", "return_date": "2026-10-26", "departure_date": "2026-10-19", "flight_duration": "2 hr 23 min", "destination_city": "Philadelphia", "round_trip_price": 128, "google_flights_link": "https://www.google.com/travel/flights?q=Flights+from+Chicago+to+Philadelphia+on+2026-10-19+through+2026-10-26&curr=USD" , "destination_image_link": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQ6OWexyxWA8QRv4R9JAdkAuADMy8eVh4Rv3pAmqJKysRUfM5l2PE-ByobWMCuaXcTMR2vI7jGuxAxMI0-41M_yJK_d_8T5Ojf0g3hIfHg" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"google.com/list_cheap_destinations","input":{"origin":"Chicago"}}' # 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": "google.com/list_cheap_destinations" , "input": { "origin": "Chicago" }})# 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": "google.com/list_cheap_destinations" , "input": { "origin": "Chicago" } }), 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 google.com/list_cheap_destinations# with {"origin":"Chicago"}"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" ], "properties": { "month": { "type": "string", "default": "", "description": "Travel month as YYYY-MM, for example 2026-11; blank searches the next six months." }, "origin": { "type": "string", "description": "Departure city or airport, for example Chicago." }, "region": { "type": "string", "default": "", "description": "Destination country or continent, for example Europe; blank means anywhere." }, "currency": { "type": "string", "default": "USD", "description": "Currency code, for example USD." }, "max_results": { "type": "integer", "default": 30, "maximum": 100, "minimum": 1, "description": "Maximum destinations, for example 30." }, "trip_length": { "enum": [ "weekend", "one_week", "two_weeks" ], "type": "string", "default": "one_week", "description": "Trip length, for example weekend." }, "nonstop_only": { "type": "boolean", "default": false, "description": "Only show nonstop flights, for example false." } }}Output schema
{ "type": "object", "required": [ "destinations" ], "properties": { "destinations": { "type": "array", "items": { "type": "object", "required": [ "destination_city", "country", "round_trip_price", "currency", "departure_date", "return_date", "flight_duration", "stops", "airline", "destination_image_link", "google_flights_link" ], "properties": { "stops": { "type": [ "integer", "null" ] }, "airline": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "currency": { "type": "string" }, "return_date": { "type": [ "string", "null" ] }, "departure_date": { "type": [ "string", "null" ] }, "flight_duration": { "type": [ "string", "null" ] }, "destination_city": { "type": "string" }, "round_trip_price": { "type": "number" }, "google_flights_link": { "type": "string" }, "destination_image_link": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
google.com/list_cheap_destinations- Returns
- destination city, country, round-trip price, dates, flight duration, stops, airline, image, Google Flights 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 google.com/list_cheap_destinations with the inputs above.
Ask your agent
- What are the cheapest places I can fly round-trip from Chicago for a week in November 2026?
- Show me budget nonstop weekend getaways from Denver, sorted by price.
- Use Google Travel Explore to find the 10 cheapest two-week trips from Boston to Europe in March 2027, with prices in EUR.
- I'm in Seattle and want a cheap one-week vacation somewhere in Asia sometime in the next six months — which destinations have the lowest round-trip fares?
- Pull a list of the 50 cheapest destinations from Atlanta on Google Flights, nonstop only, for a weekend trip in October 2026.
See more
All Google methodsFinds 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_flightsFinds 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 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.com/search_hotelsGets up to three Google Maps routes between two places, with distances, travel times and step-by-step directions.
google.com/get_directionsFinds 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.com/get_hotel_reviewsLists major stock market indexes on Google Finance with their current levels, changes and quote times. Quotes may be delayed, and indexes Google does not show are left out.
google.com/list_market_indexesShows where a search term has the highest relative Google Trends interest, by country worldwide or by region within a country. Scores run from 0 to 100.
trends.google.com/get_interest_by_regionFinds 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.
adstransparency.google.com/get_company_ads