google-flights
Advanced tools
Google Flights API is an unofficial NodeJS class that allows you to make calls to Google's public backend for flight aggregation data. This project is unaffiliated with Google, and they reserve all rights to their data.
This code is being actively worked on, so the following implementations are no longer correct.
const gfAPI = new GoogleFlightsAPI({
originIdentifier: '/m/0d6lp', // Google's id for San Francisco
outboundDate: '2023-08-21', // Date of departing flight in YYYY-MM-DD
destinationIdentifier: '/m/030qb3t', // Google's id for Los Angeles
returnDate: '2023-08-25', // Date of return flight in YYYY-MM-DD
roundtrip: true, // Roundtrip vs one-way flight search
seatClass: SeatClass.ECONOMY, // Class of seat, in this case Economy class
stops: Stops.NONSTOP // How many stops are okay, a value from 0-2
});
const results = await GoogleFlightsAPI.locationSearch('Honolulu');
// results =
[
{
type: 'city',
fullName: 'Honolulu, Hawaii',
shortName: 'Honolulu',
description: 'City in Hawaii',
identifier: '/m/02hrh0_',
airports: [
{
type: 'airport',
name: 'Daniel K. Inouye International Airport',
city: 'Honolulu',
identifier: '/m/02hrh0_',
code: 'HNL',
distance: '4 mi'
}
]
}
]
const results = await gfAPI.explore();
// results =
[
{
identifier: '/m/030qb3t',
coordinates: [ 34.0522342, -118.2436849 ],
city: 'Los Angeles',
country: 'United States',
listingPictureUrl: 'https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR4WoWSategKIa29GTDRnXJBazMO3TWR83GPi4cN8uuwa1mLiSqRLI2p264hXuepRAWuapLZX72RChLpe5GYcqtqJlmqb5ILZDpmpygjn0',
coverPictureUrl: 'https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTARk3fg4JrXocEwFZ__Vu1gTQq_0fAQykb5FfW16JDWxFEvSzsdWXG8thXEjtdTNrnGpD6L0OVyiRFQb3xGcQk6R1qWqf3S-SjvkZccA',
flight: {
price: 103,
stops: 0,
length: 104,
lengthString: '1 hr 44 min',
iata: 'UA',
airline: 'United',
airlineLogoUrl: 'https://www.gstatic.com/flights/airline_logos/70px/dark/UA.png',
arrivalAirport: 'LAX',
arrivalAirportIdentifier: '/m/0d6lp'
}
},
{
identifier: '/m/02_286',
coordinates: [ 40.7127753, -74.0059728 ],
city: 'New York',
country: 'United States',
listingPictureUrl: 'https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNy5MlPWw65goD3Mqow7kGiF9iYfFPlQgc_Ie7sJTSNK84RJ9uAK4rAuaf6Lis1YYt5qzwAjy7dLfeuKFZgEgI0E7tsLFMyOklGP3cEOo',
coverPictureUrl: 'https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTSy0LlOnvIOKZvVBa0YMy-1LPf54ANwcklVvu2RrMCQaCFtmMJmktOtpCLF8ax9ZPKSjInoe3DlCOfBKpmC53nnRpMtZ5qDHyCZJzRPg',
flight: {
price: 253,
stops: 0,
length: 334,
lengthString: '5 hr 34 min',
iata: 'AS',
airline: 'Alaska',
airlineLogoUrl: 'https://www.gstatic.com/flights/airline_logos/70px/dark/AS.png',
arrivalAirport: 'EWR',
arrivalAirportIdentifier: '/m/0d6lp'
}
},
...
{
identifier: '/m/0x1y7',
coordinates: [ 45.6793119, -111.037259 ],
city: 'Bozeman',
country: 'United States',
listingPictureUrl: 'https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ8aCEFmb9agCsLNKGrxcqzQOfdqL5h481pV_8rbb1lDgLN7I-WreiLPh5NdOyEPCdeXvH0W3yyLUNMFpIrcgBlI53_3dcGseKannXi6nc',
coverPictureUrl: 'https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTuAMfjkrYMNCLnUYNB7MD-cwyfYNu9qOJzkn0wPQ4Sk5Z_cDMcsvi6StRZIADVoK29ZFPlVKeRpm0OoRlsz9NJD85WRGcsWP4GX5b0Sg',
flight: {
price: 214,
stops: 0,
length: 134,
lengthString: '2 hr 14 min',
iata: 'UA',
airline: 'United',
airlineLogoUrl: 'https://www.gstatic.com/flights/airline_logos/70px/dark/UA.png',
arrivalAirport: 'BZN',
arrivalAirportIdentifier: '/m/0d6lp'
}
},
{
identifier: '/m/0310cy',
coordinates: [ 23.0636562, -109.7024376 ],
city: 'San José del Cabo',
country: 'Mexico',
listingPictureUrl: 'https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQUvSUomuy3IfW1eVzJmfrohNMClhBxWIQ7Zy_F1y45CSV9_JbqA0-3wTprHTFxN6v6IfCnuCj54OlzxPEKT4wFWi-d12GAuINF82KoQQs',
coverPictureUrl: 'https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRzgrK9nhRb8U2OOcjCU3AxMKcS5yU27AFSV-s0BwhPxRfCogWd6HAZZweaXswbGzAGY2q4IcjzcTF07a6-yW0q5ZApYSbQLJmwtAxOEw',
flight: {
price: 295,
stops: 0,
length: 190,
lengthString: '3 hr 10 min',
iata: 'AS',
airline: 'Alaska',
airlineLogoUrl: 'https://www.gstatic.com/flights/airline_logos/70px/dark/AS.png',
arrivalAirport: 'SJD',
arrivalAirportIdentifier: '/m/0d6lp'
}
}
]
const results = await gfAPI.search();
// results =
[
{
airlineCode: 'AS',
airlines: [ 'Alaska' ],
legs: [
{
airlineOperator: null,
departure: {
airport: { code: 'SFO', name: 'San Francisco International Airport' },
time: { hours: 7, minutes: 0 },
date: { year: 2023, month: 8, day: 21 }
},
arrival: {
airport: {
code: 'HNL',
name: 'Daniel K. Inouye International Airport'
},
time: { hours: 9, minutes: 33 },
date: { year: 2023, month: 8, day: 21 }
},
duration: 333,
legroom: '31 in',
aircraft: 'Boeing 737',
flightNumber: { code: 'AS', number: '870', name: 'Alaska' },
emissions: 258990,
amenities: {
u1: false,
powerUSB: true,
u3: false,
powerOutlet: false,
u5: false,
u6: false,
u7: false,
u8: false,
liveTV: false,
u10: false,
streamMedia: true,
wifiFree: false,
wifiPaid: true
}
}
],
departure: {
airport: { code: 'SFO', name: null },
date: { year: 2023, month: 8, day: 21 },
time: { hours: 7, minutes: 0 }
},
arrival: {
airport: { code: 'HNL', name: null },
date: { year: 2023, month: 8, day: 21 },
time: { hours: 9, minutes: 33 }
},
duration: 333,
price: 134
},
{
airlineCode: 'UA',
airlines: [ 'United' ],
legs: [
{
airlineOperator: null,
departure: {
airport: { code: 'SFO', name: 'San Francisco International Airport' },
time: { hours: 16, minutes: 55 },
date: { year: 2023, month: 8, day: 21 }
},
arrival: {
airport: {
code: 'HNL',
name: 'Daniel K. Inouye International Airport'
},
time: { hours: 19, minutes: 16 },
date: { year: 2023, month: 8, day: 21 }
},
duration: 321,
legroom: '31 in',
aircraft: 'Boeing 777',
flightNumber: { code: 'UA', number: '1509', name: 'United' },
emissions: 285685,
amenities: {
u1: false,
powerUSB: false,
u3: false,
powerOutlet: true,
u5: false,
u6: false,
u7: false,
u8: false,
liveTV: false,
u10: false,
streamMedia: true,
wifiFree: false,
wifiPaid: true
}
}
],
departure: {
airport: { code: 'SFO', name: null },
date: { year: 2023, month: 8, day: 21 },
time: { hours: 16, minutes: 55 }
},
arrival: {
airport: { code: 'HNL', name: null },
date: { year: 2023, month: 8, day: 21 },
time: { hours: 19, minutes: 16 }
},
duration: 321,
price: 134
},
...
{
airlineCode: 'AS',
airlines: [ 'Alaska' ],
legs: [
{
airlineOperator: null,
departure: {
airport: { code: 'SFO', name: 'San Francisco International Airport' },
time: { hours: 11, minutes: 40 },
date: { year: 2023, month: 8, day: 21 }
},
arrival: {
airport: {
code: 'HNL',
name: 'Daniel K. Inouye International Airport'
},
time: { hours: 14, minutes: 13 },
date: { year: 2023, month: 8, day: 21 }
},
duration: 333,
legroom: '31 in',
aircraft: 'Boeing 737MAX 9 Passenger',
flightNumber: { code: 'AS', number: '877', name: 'Alaska' },
emissions: 216842,
amenities: {
u1: false,
powerUSB: true,
u3: false,
powerOutlet: false,
u5: false,
u6: false,
u7: false,
u8: false,
liveTV: false,
u10: false,
streamMedia: true,
wifiFree: false,
wifiPaid: true
}
}
],
departure: {
airport: { code: 'SFO', name: null },
date: { year: 2023, month: 8, day: 21 },
time: { hours: 11, minutes: 40 }
},
arrival: {
airport: { code: 'HNL', name: null },
date: { year: 2023, month: 8, day: 21 },
time: { hours: 14, minutes: 13 }
},
duration: 333,
price: 204
}
]
const results = await api.book([result]);
// results =
[
{
vendor: 'Alaska',
vendorCode: 'AS',
vendorHomepage: 'www.alaskaair.com/...',
link: 'https://www.google.com/travel/clk/f',
linkData: [ [Array] ],
price: 134,
fareType: 'SAVER'
},
{
vendor: 'Alaska',
vendorCode: 'AS',
vendorHomepage: 'www.alaskaair.com/...',
link: 'https://www.google.com/travel/clk/f',
linkData: [ [Array] ],
price: 174,
fareType: 'MAIN'
},
{
vendor: 'Alaska',
vendorCode: 'AS',
vendorHomepage: 'www.alaskaair.com/...',
link: 'https://www.google.com/travel/clk/f',
linkData: [ [Array] ],
price: 574,
fareType: 'FIRST'
},
{
vendor: 'CheapoFlyt',
vendorCode: 'CHEAPOFLYT',
vendorHomepage: 'cheapoflyt.com/...',
link: 'https://www.google.com/travel/clk/f',
linkData: [ [Array] ],
price: 130,
fareType: null
},
...
{
vendor: 'Globehunters',
vendorCode: 'GLOBEHUNTERS',
vendorHomepage: 'www.globehunters.us/...',
link: 'https://www.google.com/travel/clk/f',
linkData: [ [Array] ],
price: 234,
fareType: null
}
]
const [ locationDep ] = await GoogleFlightsAPI.locationSearch('San Francisco');
const [ locationArr ] = await GoogleFlightsAPI.locationSearch('honolulu');
const params = {
originIdentifier: locationDep.identifier,
outboundDate: '2023-08-21',
returnDate: '2023-08-25',
seatClass: SeatClass.ECONOMY,
roundtrip: true,
passengers: {
adults: 1
},
stops: Stops.NONSTOP,
}
console.log(`Looking for somewhere to go from ${params.outboundDate} to ${params.returnDate}`);
const api = new GoogleFlightsAPI(params);
const [discoverResult] = await api.explore();
console.log(`Discovered ${discoverResult.city} for $${discoverResult.flight.price}`);
api.editConfig({
destinationIdentifier: discoverResult.identifier
});
const [originResult] = await api.search();
console.log(`Found ${originResult.airlines[0]} flight from ${originResult.departure.airport.code} to ${originResult.arrival.airport.code}`);
const [destinationResult] = await api.search(originResult.legs[0]);
console.log(`Found ${destinationResult.airlines[0]} flight from ${destinationResult.departure.airport.code} to ${destinationResult.arrival.airport.code}`);
const [bookingInfo] = await api.book([originResult, destinationResult]);
const bookingLink = await GoogleFlightsAPI.getBookingLink(bookingInfo);
console.log(bookingLink);
console.log(`New search! Going to Honolulu`);
api.editConfig({
destinationIdentifier: locationArr.identifier,
roundtrip: false
});
const [result] = await api.search();
console.log(`Found ${result.airlines[0]} flight from ${result.departure.airport.code} to ${result.arrival.airport.code} for $${result.price}`);
const [paradiseBookingInfo] = await api.book([result]);
const paradiseBookingLink = await GoogleFlightsAPI.getBookingLink(paradiseBookingInfo);
console.log(paradiseBookingLink);
Example response:
Looking for somewhere to go from 2023-08-21 to 2023-08-25
Discovered Los Angeles for $103
Found United flight from SFO to LAX
Found United flight from LAX to SFO
https://www.united.com/ual/en/us/Booking/SearchInjection/VendorQueryPinDown?encodedParameters=cd7cfde9-db6b-4cb0-8bd7-5de08273bb9d%5e1af4ede1-6109-40c6-87a6-860b30e24374
New search! Going to Honolulu
Found Alaska flight from SFO to HNL for $134
https://www.alaskaair.com/planbook/shoppingstart?A=1&SITE_PREF=full&FT=ow&F1=SFO%7CHNL%7C08/21/2023%7C870,AS%7CS&FARE=133.50&frm=cart&meta=GOO_CS_Other_X&utm_source=google&utm_medium=meta&utm_campaign=book_as_site&gclid=ACO7Af3PtHZzFvqerhwbe_c7eD-7gPT8yAg7tO0kKEnG7gktqaV_P13jJoMsIlkePc-lw9T2zWk2xysdy8Y1LMf3vWjOjEWXmSpa5GiCbMkKgf-X7ZA&gclsrc=gf
FAQs
An unofficial API for Google Flights
The npm package google-flights receives a total of 2 weekly downloads. As such, google-flights popularity was classified as not popular.
We found that google-flights demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Elastic’s return to open source with the AGPL license has been met with skepticism, as many developers see it as a strategic move rather than a genuine effort to restore user trust and freedoms.
Security News
A new "revival hijack" supply chain attack targets deleted Python packages, with an estimated 22K packages at risk. Socket can detect and block hijacked packages that have added malicious code.
Product
We're introducing a new Analytics feature in the Socket dashboard so you can view changes in your organization's and repositories' alerts over time.