Google Flights Real Time API

Search for cheap flights on Google Flights via a simple REST API.

Endpoints

One-way flights

POST /oneway

Search for one-way flights between two airports on a given date.

Round-trip flights

POST /roundtrip

Search for round-trip flights between two airports with departure and return dates.

Request body (JSON)

Common fields (both endpoints)

Field	Type	Required	Description
departure_date	string	Yes	Departure date YYYY-MM-DD
from_airport	string	Yes	Departure airport IATA code
to_airport	string	Yes	Destination airport IATA code
currency	string	No	Currency code (default usd)
max_price	integer	No	Maximum price filter
seat_type	integer	No	1 = Economy, 3 = Business
passengers	int[]	No	Passenger age codes

One-way only

Field	Type	Description
max_stops	integer	Maximum number of stops
airline_codes	string[]	Include only these airlines
exclude_airline_codes	string[]	Exclude these airlines
departure_time_min	integer	Earliest departure hour (0-23)
departure_time_max	integer	Latest departure hour (0-23)
arrival_time_min	integer	Earliest arrival hour (0-23)
arrival_time_max	integer	Latest arrival hour (0-23)

Round-trip only

Field	Type	Description
return_date	string	Return date YYYY-MM-DD (required)
max_departure_stops	integer	Max stops on outbound leg
max_return_stops	integer	Max stops on return leg
departure_airline_codes	string[]	Include only these airlines (outbound)
departure_exclude_airline_codes	string[]	Exclude airlines (outbound)
return_airline_codes	string[]	Include only these airlines (return)
return_exclude_airline_codes	string[]	Exclude airlines (return)
departure_departure_time_min	integer	Outbound earliest departure hour
departure_departure_time_max	integer	Outbound latest departure hour
departure_arrival_time_min	integer	Outbound earliest arrival hour
departure_arrival_time_max	integer	Outbound latest arrival hour
return_departure_time_min	integer	Return earliest departure hour
return_departure_time_max	integer	Return latest departure hour
return_arrival_time_min	integer	Return earliest arrival hour
return_arrival_time_max	integer	Return latest arrival hour

Example

One-way request

POST /oneway
{
    "departure_date": "2026-04-15",
    "from_airport": "JFK",
    "to_airport": "TLV",
    "max_stops": 1,
    "currency": "usd"
}

Round-trip request

POST /roundtrip
{
    "departure_date": "2026-04-15",
    "return_date": "2026-04-22",
    "from_airport": "JFK",
    "to_airport": "TLV",
    "currency": "usd"
}

Response

Both endpoints return a JSON array of flight results sorted by best overall value. price_insights_low and price_insights_high represent Google's historical price range for the searched route and travel dates.

One-way response item example:

{
    "price_range_in_relation_to_other_periods": "low",
    "price_insights_low": 65,
    "price_insights_high": 135,
    "from_airport": "Berlin (BER)",
    "to_airport": "Paris (CDG)",
    "departure_date": "2026-06-15",
    "price": "$56",
    "price_as_number": 56,
    "duration": "1 hr 50 min",
    "duration_seconds": 6600,
    "buy_link": "https://www.google.com/travel/flights?tfs=GjwSCjIwMjYtMDYtMTUiIAoDQkVSEgoyMDI2LTA2LTE1GgNDREcqAlUyMgQ1MTYxagUSA0JFUnIFEgNDREdCAQFIAZgBAg&curr=usd",
    "airline": "easyJet",
    "stops": 0,
    "stops_info": [],
    "departure_description": "10:15 AM on Mon, Jun 15",
    "arrival_description": "12:05 PM on Mon, Jun 15"
}

stops_info is an array describing each layover. Empty when nonstop. For flights with stops:

"stops_info": [
    {
        "stop_airport": "AUH",
        "stop_duration_seconds": 5700
    }
]

Round-trip response item example:

{
    "price_range_in_relation_to_other_periods": "low",
    "price_insights_low": 135,
    "price_insights_high": 205,
    "from_airport": "Berlin (BER)",
    "to_airport": "Paris (CDG)",
    "departure_date": "2026-06-01",
    "return_date": "2026-06-05",
    "total_price": "$119",
    "total_price_as_number": 119,
    "total_duration_seconds": 12900,
    "total_stops": 0,
    "buy_link": "https://www.google.com/travel/flights?tfs=GjwSCjIwMjYtMDYtMDEiIAoDQkVSEgoyMDI2LTA2LTAxGgNDREcqAlUyMgQ1MTU5agUSA0JFUnIFEgNDREcaPBIKMjAyNi0wNi0wNSIgCgNDREcSCjIwMjYtMDYtMDUaA0JFUioCVTIyBDUxNjJqBRIDQ0RHcgUSA0JFUkIBAUgBmAEB&curr=usd",
    "departure_flight_departure_description": "7:00 AM on Mon, Jun 1",
    "departure_flight_arrival_description": "8:50 AM on Mon, Jun 1",
    "departure_flight_airline": "easyJet",
    "departure_flight_stops": 0,
    "departure_flight_duration": "1 hr 50 min",
    "departure_stops_info": [],
    "return_flight_departure_description": "8:20 PM on Fri, Jun 5",
    "return_flight_arrival_description": "10:05 PM on Fri, Jun 5",
    "return_flight_airline": "easyJet",
    "return_flight_stops": 0,
    "return_flight_duration": "1 hr 45 min",
    "return_stops_info": []
}

departure_stops_info and return_stops_info are arrays describing each layover for the departure and return flights respectively. Empty when nonstop. For flights with stops:

"departure_stops_info": [
    {
        "stop_airport": "CDG",
        "stop_duration_seconds": 46800
    },
    {
        "stop_airport": "BLR",
        "stop_duration_seconds": 34200
    }
]