This page describes the structure and meaning of fields returned by the Google Flights API. The response contains metadata about the request and a list of flights results from Google Flights.
Field Summary
The table below provides a quick overview of the main fields returned by the Google Flights API response.
Field
Type
Description
url
string
The final Google Flights URL used to retrieve the results
general
object
Metadata describing the request environment and search configuration
input
object
Information about the original request processed by the API
organic
array
Reserved field; always returned as an empty array
flights
array
List of flight result objects extracted from Google Flights
pagesProcessed
integer
Number of result pages processed to build the response
Flight Object Fields Summary
Each element inside the flights array contains the following fields:
Field
Type
Description
departure_time
string
Departure time of the first leg
total_duration
string
Total journey time including any layovers
stops
integer
Number of stops in the itinerary
total_emissions
string
Estimated CO2 emissions for the full itinerary
price
string
Formatted price string
price_raw
integer
Numeric price value without formatting
legs
array
List of individual flight segments
rank
integer
Position of the flight in the returned results
Top-Level Fields
url
The final Google Flights URL used to retrieve the results. This URL reflects the fully constructed search query including route, dates, and encoded Google parameters.
Example
general
Metadata describing the request environment and search configuration.
Fields
Field
Type
Description
searchEngine
string
Always google_flights
language
string
Language code used for the search
device
string
Device type used for the request
searchType
string
Type of search performed
pageTitle
string
Page title returned by Google
timestamp
string
ISO 8601 timestamp of when the request was executed
render
boolean
Whether the page was rendered with JavaScript
Example
input
Information about the original request processed by the API.
Fields
Field
Type
Description
originalUrl
string
The Google Flights URL that was fetched
jobId
string
Unique identifier for the API job
Example
Flights Array
The flights field contains a list of flight objects extracted from Google Flights. Each object represents a single itinerary option.
Example
Flight Object Fields
departure_time
Departure time of the first leg of the itinerary.
total_duration
Total journey time from origin to destination, including layover time for connecting flights.
stops
Number of stops in the itinerary. 0 indicates a nonstop flight.
total_emissions
Estimated CO2 emissions for the full itinerary across all legs.
price
Formatted price string for the itinerary.
price_raw
Numeric price value without currency formatting. Useful for sorting and comparison logic.
legs
List of individual flight segments that make up the itinerary. Nonstop flights contain one leg. Connecting flights contain one leg per segment.
Leg Object Fields
Field
Type
Description
departure_airport
object
Origin airport for this segment. Contains name, id (IATA code), and time
arrival_airport
object
Destination airport for this segment. Contains name, id (IATA code), and time
duration
string
Flight time for this segment
overnight
boolean
Whether this segment crosses midnight
airplane
string
Aircraft type
airline
string
Airline name
airline_logo
string
URL to the airline logo image
travel_class
string
Cabin class (e.g., Economy)
flight_number
string
IATA flight number
amenities
array
List of onboard amenities and per-segment emissions data
rank
Position of the flight in the returned search results, starting from 1.
"general": {
"searchEngine": "google_flights",
"language": "en",
"device": "desktop",
"searchType": "text",
"pageTitle": "New York to Los Angeles | Google Flights",
"timestamp": "2026-06-01T16:02:22.487780767Z",
"render": false
}
