Google Flights API
Our Google Flights API allows you to scrape flight results from Google Flights. The API is accessed through the following endpoint: /search?engine=google_flights.
A user may query the following: https://serpapi.com/search?engine=google_flights utilizing a GET request. Head to the playground for a live and interactive demo.
API Parameters
Search Query
departure_id
Required
Parameter defines the departure airport code or city ID.
An airport code is an uppercase 3-letter code. You can search for it on Google Flights or IATA.
For example, CDG is Paris Charles de Gaulle Airport and AUS is Austin-Bergstrom International Airport.
A city ID is a string that starts with /m/. For example, /m/0vzm is the city ID for Austin, TX.
arrival_id
Required
Parameter defines the arrival airport code or city ID.
An airport code is an uppercase 3-letter code. You can search for it on Google Flights or IATA.
For example, CDG is Paris Charles de Gaulle Airport and AUS is Austin-Bergstrom International Airport.
A city ID is a string that starts with /m/. For example, /m/0vzm is the city ID for Austin, TX.
Localization
hl
Optional
Parameter defines the language to use for the Google Flights search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.
currency
Optional
Parameter defines the currency of the returned prices. Default to USD. Head to the Google Travel Currencies page for a full list of supported currency codes.
Advanced Google Flights Parameters
type
Optional
Parameter defines the type of the flights.
Available options:1 - Round trip (default)2 - One way
outbound_date
Required
Parameter defines the outbound date. The format is YYYY-MM-DD. e.g. 2023-12-06
Advanced Filters
stops
Optional
Parameter defines the number of stops during the flight.
Available options:0 - Any number of stops (default)1 - Nonstop only2 - 1 stop or fewer3 - 2 stops or fewer
exclude_airlines
Optional
Parameter defines the airline codes to be excluded. Split multiple airlines with comma.
It can't be used together with include_airlines.
Each airline code should be an uppercase 2-letter code. You can search for airline codes on IATA.
For example, UA is United Airlines.
exclude_airlines and include_airlines parameters can't be used together.
include_airlines
Optional
Parameter defines the airline codes to be included. Split multiple airlines with comma.
It can't be used together with exclude_airlines.
Each airline code should be an uppercase 2-letter code. You can search for airline codes on IATA.
For example, UA is United Airlines.
Additionally, Alliances can be also included here:STAR_ALLIANCE - Star AllianceSKYTEAM - SkyTeamONEWORLD - Oneworld
exclude_airlines and include_airlines parameters can't be used together.
outbound_times
Optional
Parameter defines the outbound times range. It's a two-number string. Each number represents the beginning of an hour. For example, specify:4,18 for 4:00 AM - 7:00 PM0,18 for 12:00 AM - 7:00 PM19,23 for 7:00 PM - 12:00 AM
return_times
Optional
Parameter defines the return times range. It's a two-number string. Each number represents the beginning of an hour. For example, specify:4,18 for 4:00 AM - 7:00 PM0,18 for 12:00 AM - 7:00 PM19,23 for 7:00 PM - 12:00 AM
Parameter should only be used when type parameter is set to: 1 (Round trip)
emissions
Optional
Parameter defines the emission level of the flight.
Available options:1 - Less emissions only
layover_duration
Optional
Parameter defines the layover duration, in minutes. It's a two-number string. For example, specify 90,330 for 1 hr 30 min - 5 hr 30 min.
exclude_conns
Optional
Parameter defines the connecting airport codes to be excluded.
An airport ID is an uppercase 3-letter code. You can search for it on Google Flights or IATA.
For example, CDG is Paris Charles de Gaulle Airport and AUS is Austin-Bergstrom International Airport.
You can also combine multiple Airports by joining them with a comma (value + , + value; eg: CDG,AUS).
Serpapi Parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Google Flights results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together.
API Results
JSON Results
JSON output includes structured data for Flight Results and Price Insights.
A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.
HTML Results
This API does not have html response, just a text. search_metadata.prettify_html_file contains prettified version of result. It is displayed in playground.
API Examples
JSON structure overview
{
...
"best_flights": [
// best_flights is not always returned
{
"flights": [
{
"departure_airport": {
"name": "String - Departure airport name",
"id": "String - Departure airport code",
"time": "String - Departure time"
},
"arrival_airport": {
"name": "String - Arrival airport name",
"id": "String - Arrival airport code",
"time": "String - Arrival time"
},
"duration": "Integer - Flight duration, in minutes",
"airplane": "String - Airplane model",
"airline": "String - Name of the airline",
"airline_logo": "String - URL to the logo of the airline",
"travel_class": "String - Travel class",
"flight_number": "String - The flight number",
"extensions": "Array - A list of flight features",
"ticket_also_sold_by": "Array - A list of other sellers",
"legroom": "String - The legroom, including unit",
"overnight": "Boolean - Returns 'true' if the flight is overnight",
"often_delayed_by_over_30_min": "Boolean - Returns 'true' if the flight is often delayed by 30+ min.",
}
],
"layovers": [
{
"duration": "Integer - Duration of the layover, in minutes",
"name": "String - Name of the airport for the layover",
"id": "String - The airport code for the layover",
"overnight": "Boolean - Returns 'true' if the layover is overnight",
}
],
"total_duration": "Integer - Total minutes of all flights and layovers",
"carbon_emissions": {
"this_flight": "Integer - The amount of carbon emissions of the flight, in grams",
"typical_for_this_route": "Integer - Typical amount of carbon emissions for the route, in grams",
"difference_percent": "Integer - The carbon emissions difference between the flight and typical value, in percent",
},
"price": "Integer - This ticket price in the selected currency, the default currency is USD",
"type": "String - The type of the flight. It's a reflection of the request parameter `type`",
"airline_logo": "String - URL to the logo of mixed airlines",
"extensions": "Array - A list of features of the entire flight",
"departure_token": "String - The token for retrieving returning flights when the flight type is 'Round trip'",
}
],
"other_flights": [
// The same structure as best_flights
// When the results are not separated into best_flights and other_flights, they are in other_flights
]
"price_insights": {
"lowest_price": "Integer - The lowest price among the returned flights",
"price_level": "String - Price level of the lowest_price",
"typical_price_range": "Array - A two-integer array, indicating the low bound and high bound of 'typical' price of this flight",
"price_history": "Array - A two-integer array, where the first element is the timestamp, and the second one is the price",
},
...
}
Typical Example
{
"search_metadata": {
"id": "651a585815afff2d53eb9a5e",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/e65fd34e00db9b2b/651a585815afff2d53eb9a5e.json",
"created_at": "2023-10-02 05:42:48 UTC",
"processed_at": "2023-10-02 05:42:48 UTC",
"google_flights_url": "https://www.google.com/travel/flights?hl=en",
"raw_html_file": "https://serpapi.com/searches/e65fd34e00db9b2b/651a585815afff2d53eb9a5e.html",
"prettify_html_file": "https://serpapi.com/searches/e65fd34e00db9b2b/651a585815afff2d53eb9a5e.prettify",
"total_time_taken": 0.71
},
"search_parameters": {
"engine": "google_flights",
"hl": "en",
"departure_id": "PEK",
"arrival_id": "AUS",
"outbound_date": "2023-10-03",
"return_date": "2023-10-09",
"currency": "USD"
},
"best_flights": [
{
"flights": [
{
"departure_airport": {
"name": "Beijing Capital International Airport",
"id": "PEK",
"time": "2023-10-03 15:10"
},
"arrival_airport": {
"name": "Haneda Airport",
"id": "HND",
"time": "2023-10-03 19:35"
},
"duration": 205,
"airplane": "Boeing 787",
"airline": "ANA",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/NH.png",
"travel_class": "Economy",
"flight_number": "NH 962",
"legroom": "31 in",
"extensions": [
"Average legroom (31 in)",
"Wi-Fi for a fee",
"In-seat power & USB outlets",
"On-demand video",
"Carbon emissions estimate: 133 kg"
]
},
{
"departure_airport": {
"name": "Haneda Airport",
"id": "HND",
"time": "2023-10-03 21:05"
},
"arrival_airport": {
"name": "Los Angeles International Airport",
"id": "LAX",
"time": "2023-10-03 15:10"
},
"duration": 605,
"airplane": "Boeing 787",
"airline": "ANA",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/NH.png",
"travel_class": "Economy",
"flight_number": "NH 126",
"ticket_also_sold_by": [
"United"
],
"legroom": "32 in",
"extensions": [
"Above average legroom (32 in)",
"In-seat power & USB outlets",
"On-demand video",
"Carbon emissions estimate: 836 kg"
],
"overnight": true
},
{
"departure_airport": {
"name": "Los Angeles International Airport",
"id": "LAX",
"time": "2023-10-03 19:01"
},
"arrival_airport": {
"name": "Austin-Bergstrom International Airport",
"id": "AUS",
"time": "2023-10-03 23:59"
},
"duration": 178,
"airplane": "Boeing 737MAX 9 Passenger",
"airline": "United",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/UA.png",
"travel_class": "Economy",
"flight_number": "UA 2175",
"legroom": "30 in",
"extensions": [
"Average legroom (30 in)",
"Wi-Fi for a fee",
"In-seat power outlet",
"Stream media to your device",
"Carbon emissions estimate: 135 kg"
]
}
],
"layovers": [
{
"duration": 90,
"name": "Haneda Airport",
"id": "HND"
},
{
"duration": 231,
"name": "Los Angeles International Airport",
"id": "LAX"
}
],
"total_duration": 1309,
"carbon_emissions": {
"this_flight": 1106000,
"typical_for_this_route": 949000,
"difference_percent": 17
},
"price": 2512,
"type": "Round trip",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/multi.png",
"departure_token": "W1siUEVLIiwiMjAyMy0xMC0wMyIsIkhORCIsbnVsbCwiTkgiLCI5NjIiXSxbIkhORCIsIjIwMjMtMTAtMDMiLCJMQVgiLG51bGwsIk5IIiwiMTI2Il0sWyJMQVgiLCIyMDIzLTEwLTAzIiwiQVVTIixudWxsLCJVQSIsIjIxNzUiXV0="
},
{
"flights": [
{
"departure_airport": {
"name": "Beijing Capital International Airport",
"id": "PEK",
"time": "2023-10-03 10:40"
},
"arrival_airport": {
"name": "Incheon International Airport",
"id": "ICN",
"time": "2023-10-03 13:50"
},
"duration": 130,
"airplane": "Airbus A330",
"airline": "Asiana",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/OZ.png",
"travel_class": "Economy",
"flight_number": "OZ 332",
"legroom": "32 in",
"extensions": [
"Above average legroom (32 in)",
"In-seat power outlet",
"On-demand video",
"Carbon emissions estimate: 84 kg"
]
},
{
"departure_airport": {
"name": "Incheon International Airport",
"id": "ICN",
"time": "2023-10-03 20:55"
},
"arrival_airport": {
"name": "San Francisco International Airport",
"id": "SFO",
"time": "2023-10-03 15:30"
},
"duration": 635,
"airplane": "Airbus A350",
"airline": "Asiana",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/OZ.png",
"travel_class": "Economy",
"flight_number": "OZ 212",
"legroom": "32 in",
"extensions": [
"Above average legroom (32 in)",
"Wi-Fi for a fee",
"In-seat power & USB outlets",
"On-demand video",
"Carbon emissions estimate: 619 kg"
],
"overnight": true,
"often_delayed_by_over_30_min": true
},
{
"departure_airport": {
"name": "San Francisco International Airport",
"id": "SFO",
"time": "2023-10-04 07:40"
},
"arrival_airport": {
"name": "Austin-Bergstrom International Airport",
"id": "AUS",
"time": "2023-10-04 13:10"
},
"duration": 210,
"airplane": "Boeing 737",
"airline": "Alaska",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AS.png",
"travel_class": "Economy",
"flight_number": "AS 512",
"legroom": "31 in",
"extensions": [
"Average legroom (31 in)",
"Wi-Fi for a fee",
"In-seat power & USB outlets",
"Stream media to your device",
"Carbon emissions estimate: 175 kg"
]
}
],
"layovers": [
{
"duration": 425,
"name": "Incheon International Airport",
"id": "ICN"
},
{
"duration": 970,
"name": "San Francisco International Airport",
"id": "SFO",
"overnight": true
}
],
"total_duration": 2370,
"carbon_emissions": {
"this_flight": 880000,
"typical_for_this_route": 949000,
"difference_percent": -7
},
"price": 2513,
"type": "Round trip",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/multi.png",
"departure_token": "W1siUEVLIiwiMjAyMy0xMC0wMyIsIklDTiIsbnVsbCwiT1oiLCIzMzIiXSxbIklDTiIsIjIwMjMtMTAtMDMiLCJTRk8iLG51bGwsIk9aIiwiMjEyIl0sWyJTRk8iLCIyMDIzLTEwLTA0IiwiQVVTIixudWxsLCJBUyIsIjUxMiJdXQ=="
},
...
],
"other_flights": [
{
"flights": [
{
"departure_airport": {
"name": "Beijing Capital International Airport",
"id": "PEK",
"time": "2023-10-03 18:30"
},
"arrival_airport": {
"name": "Incheon International Airport",
"id": "ICN",
"time": "2023-10-03 21:40"
},
"duration": 130,
"airplane": "Boeing 737MAX 8 Passenger",
"airline": "Korean Air",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/KE.png",
"travel_class": "Economy",
"flight_number": "KE 860",
"legroom": "31 in",
"extensions": [
"Average legroom (31 in)",
"Wi-Fi for a fee",
"In-seat power & USB outlets",
"Stream media to your device",
"Carbon emissions estimate: 81 kg"
]
},
{
"departure_airport": {
"name": "Incheon International Airport",
"id": "ICN",
"time": "2023-10-04 09:20"
},
"arrival_airport": {
"name": "Dallas/Fort Worth International Airport",
"id": "DFW",
"time": "2023-10-04 08:00"
},
"duration": 760,
"airplane": "Boeing 787",
"airline": "Korean Air",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/KE.png",
"travel_class": "Economy",
"flight_number": "KE 31",
"legroom": "33 in",
"extensions": [
"Above average legroom (33 in)",
"In-seat power & USB outlets",
"On-demand video",
"Carbon emissions estimate: 807 kg"
],
"overnight": true
},
{
"departure_airport": {
"name": "Dallas/Fort Worth International Airport",
"id": "DFW",
"time": "2023-10-04 09:35"
},
"arrival_airport": {
"name": "Austin-Bergstrom International Airport",
"id": "AUS",
"time": "2023-10-04 10:40"
},
"duration": 65,
"airplane": "Embraer 175",
"airline": "American",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AA.png",
"travel_class": "Economy",
"flight_number": "AA 3489",
"legroom": "30 in",
"extensions": [
"Average legroom (30 in)",
"Wi-Fi for a fee",
"In-seat power & USB outlets",
"Stream media to your device",
"Carbon emissions estimate: 60 kg"
]
}
],
"layovers": [
{
"duration": 700,
"name": "Incheon International Airport",
"id": "ICN",
"overnight": true
},
{
"duration": 95,
"name": "Dallas/Fort Worth International Airport",
"id": "DFW"
}
],
"total_duration": 1750,
"carbon_emissions": {
"this_flight": 949000,
"typical_for_this_route": 949000,
"difference_percent": 0
},
"price": 3521,
"type": "Round trip",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/multi.png",
"departure_token": "W1siUEVLIiwiMjAyMy0xMC0wMyIsIklDTiIsbnVsbCwiS0UiLCI4NjAiXSxbIklDTiIsIjIwMjMtMTAtMDQiLCJERlciLG51bGwsIktFIiwiMzEiXSxbIkRGVyIsIjIwMjMtMTAtMDQiLCJBVVMiLG51bGwsIkFBIiwiMzQ4OSJdXQ=="
},
{
"flights": [
{
"departure_airport": {
"name": "Beijing Capital International Airport",
"id": "PEK",
"time": "2023-10-03 18:30"
},
"arrival_airport": {
"name": "Incheon International Airport",
"id": "ICN",
"time": "2023-10-03 21:40"
},
"duration": 130,
"airplane": "Boeing 737MAX 8 Passenger",
"airline": "Korean Air",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/KE.png",
"travel_class": "Economy",
"flight_number": "KE 860",
"legroom": "31 in",
"extensions": [
"Average legroom (31 in)",
"Wi-Fi for a fee",
"In-seat power & USB outlets",
"Stream media to your device",
"Carbon emissions estimate: 81 kg"
]
},
{
"departure_airport": {
"name": "Incheon International Airport",
"id": "ICN",
"time": "2023-10-04 09:20"
},
"arrival_airport": {
"name": "Hartsfield-Jackson Atlanta International Airport",
"id": "ATL",
"time": "2023-10-04 09:50"
},
"duration": 810,
"airplane": "Boeing 747",
"airline": "Korean Air",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/KE.png",
"travel_class": "Economy",
"flight_number": "KE 35",
"legroom": "33 in",
"extensions": [
"Above average legroom (33 in)",
"In-seat power & USB outlets",
"On-demand video",
"Carbon emissions estimate: 954 kg"
],
"overnight": true
},
{
"departure_airport": {
"name": "Hartsfield-Jackson Atlanta International Airport",
"id": "ATL",
"time": "2023-10-04 12:59"
},
"arrival_airport": {
"name": "Austin-Bergstrom International Airport",
"id": "AUS",
"time": "2023-10-04 14:18"
},
"duration": 139,
"airplane": "Airbus A321",
"airline": "Delta",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/DL.png",
"travel_class": "Economy",
"flight_number": "DL 1384",
"ticket_also_sold_by": [
"Korean Air"
],
"legroom": "31 in",
"extensions": [
"Average legroom (31 in)",
"Free Wi-Fi",
"In-seat power & USB outlets",
"Live TV",
"Carbon emissions estimate: 109 kg"
]
}
],
"layovers": [
{
"duration": 700,
"name": "Incheon International Airport",
"id": "ICN",
"overnight": true
},
{
"duration": 189,
"name": "Hartsfield-Jackson Atlanta International Airport",
"id": "ATL"
}
],
"total_duration": 1968,
"carbon_emissions": {
"this_flight": 1146000,
"typical_for_this_route": 949000,
"difference_percent": 21
},
"price": 3521,
"type": "Round trip",
"airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/multi.png",
"departure_token": "W1siUEVLIiwiMjAyMy0xMC0wMyIsIklDTiIsbnVsbCwiS0UiLCI4NjAiXSxbIklDTiIsIjIwMjMtMTAtMDQiLCJBVEwiLG51bGwsIktFIiwiMzUiXSxbIkFUTCIsIjIwMjMtMTAtMDQiLCJBVVMiLG51bGwsIkRMIiwiMTM4NCJdXQ=="
},
...
],
"price_insights": {
"lowest_price": 2512,
"price_level": "high",
"typical_price_range": [
1500,
1900
],
"price_history": [
[
1691424000,
1877
],
[
1691510400,
1915
],
...,
[
1696089600,
2309
],
[
1696176000,
2512
]
]
}
}