Google Flights

This document provides information about the Google Flights API and the available parameters.

Google Flights API

The Google Flights API enables retrieval of Google Flights search results and returns structured JSON output. It supports flight search queries with filters such as departure and return dates, origin and destination, number of passengers, cabin class, number of stops, and more.

API Setup

Endpoint

https://serp-api.netnut.io/search

Authentication

Use HTTP Basic Authentication:

Authorization: Basic <base64(username:password)>

Where <base64(username:password)> is the Base64-encoded string of your NetNut credentials.

Request Format

The request is sent as a GET request. All parameters are passed directly in the URL query string.

Example Request

https://serp-api.netnut.io/search?engine=google_flights&flightFrom=ny&flightTo=lax&departureTime=2026-06-01&returnTime=2026-06-05&adults=1&hl=en&gl=us

Request Parameters

Parameter

Type

Required

Description

engine

string

Yes

Must be set to google_flights

flightFrom

string

Yes

Origin location. Accepts city name, airport code, or region (e.g., ny, JFK, New York)

flightTo

string

Yes

Destination location. Accepts city name, airport code, or region (e.g., lax, LAX, Los Angeles)

departureTime

string

Yes

Departure date in YYYY-MM-DD format

returnTime

string

Return date in YYYY-MM-DD format. Omit for one-way searches

adults

integer

Number of adult passengers. Defaults to 1

children

integer

Number of child passengers (ages 2-11). Defaults to 0

infants

integer

Number of lap infant passengers (under 2). Defaults to 0

travelClass

integer

Cabin class. 1 = Economy (default), 2 = Premium Economy, 3 = Business, 4 = First

stops

integer

Maximum number of stops. 0 = Nonstop only, 1 = 1 stop or fewer, 2 = 2 stops or fewer. Omit to return all results

currency

string

Currency code for prices (e.g., USD, EUR, GBP). Defaults to USD

hl

string

Language code for results (e.g., en, es, fr). Defaults to en

gl

string

Country code for localization (e.g., us, gb). Defaults to us

rawHtml

integer

1 = Return both parsed JSON and raw HTML. 2 = Return raw HTML only. Omit for JSON only

Code Examples

curl -X GET "https://serp-api.netnut.io/search?engine=google_flights&flightFrom=ny&flightTo=lax&departureTime=2026-06-01&returnTime=2026-06-05&adults=1&hl=en&gl=us" \
  -u "username:password"

import requests
from base64 import b64encode

headers = {
    "Authorization": "Basic " + b64encode(b"username:password").decode()
}

params = {
    "engine": "google_flights",
    "flightFrom": "ny",
    "flightTo": "lax",
    "departureTime": "2026-06-01",
    "returnTime": "2026-06-05",
    "adults": 1,
    "hl": "en",
    "gl": "us"
}

response = requests.get("https://serp-api.netnut.io/search", headers=headers, params=params)
print(response.json())

const username = "username";
const password = "password";

const params = new URLSearchParams({
  engine: "google_flights",
  flightFrom: "ny",
  flightTo: "lax",
  departureTime: "2026-06-01",
  returnTime: "2026-06-05",
  adults: 1,
  hl: "en",
  gl: "us"
});

const response = await fetch(`https://serp-api.netnut.io/search?${params}`, {
  method: "GET",
  headers: {
    "Authorization": "Basic " + Buffer.from(`${username}:${password}`).toString("base64")
  }
});

const data = await response.json();
console.log(data);

Response Format

The Google Flights API returns structured JSON. No HTML is returned by default. When rawHtml=1, the response includes both the parsed JSON and the raw HTML. When rawHtml=2, the response returns only the raw HTML.

Example JSON Response

{
  "url": "https://www.google.com/travel/flights/search?hl=en&gl=US&tfs=CBwQAhorEgoyMDI2LTA2LTAxag0IAxIJL20vMDJfMjg2cg4IAxIKL20vMDMwcWIzdBorEgoyMDI2LTA2LTA1ag4IAxIKL20vMDMwcWIzdHINCAMSCS9tLzAyXzI4NkABSAFwAYIBCwj___________8BmAEB&curr=USD",
  "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
  },
  "input": {
    "originalUrl": "https://www.google.com/travel/flights/search?hl=en&gl=US&tfs=CBwQAhorEgoyMDI2LTA2LTAxag0IAxIJL20vMDJfMjg2cg4IAxIKL20vMDMwcWIzdBorEgoyMDI2LTA2LTA1ag4IAxIKL20vMDMwcWIzdHINCAMSCS9tLzAyXzI4NkABSAFwAYIBCwj___________8BmAEB&curr=USD",
    "jobId": "203e0593-8bfd-49ea-a75c-8136da9d04b5"
  },
  "organic": [],
  "flights": [
    {
      "departure_time": "8:05 AM",
      "total_duration": "6 hr 15 min",
      "stops": 0,
      "total_emissions": "277 kg CO2e",
      "price": "$468",
      "price_raw": 468,
      "legs": [
        {
          "departure_airport": {
            "name": "John F. Kennedy International Airport",
            "id": "JFK",
            "time": "8:05 AM"
          },
          "arrival_airport": {
            "name": "Los Angeles International Airport",
            "id": "LAX",
            "time": "11:20 AM"
          },
          "duration": "6 hr 15 min",
          "overnight": false,
          "airplane": "Boeing 777",
          "airline": "American",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AA.png",
          "travel_class": "Economy",
          "flight_number": "AA 255",
          "amenities": [
            "Average legroom (31 in)",
            "Wi-Fi for a fee",
            "On-demand video",
            "Emissions estimate: 277 kg CO2e",
            "Contrail warming potential: Low"
          ]
        }
      ],
      "rank": 1
    },
    {
      "departure_time": "5:25 AM",
      "total_duration": "6 hr 2 min",
      "stops": 0,
      "total_emissions": "407 kg CO2e",
      "price": "$577",
      "price_raw": 577,
      "legs": [
        {
          "departure_airport": {
            "name": "John F. Kennedy International Airport",
            "id": "JFK",
            "time": "5:25 AM"
          },
          "arrival_airport": {
            "name": "Los Angeles International Airport",
            "id": "LAX",
            "time": "8:27 AM"
          },
          "duration": "6 hr 2 min",
          "overnight": true,
          "airplane": "Airbus A320",
          "airline": "JetBlue",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/B6.png",
          "travel_class": "Economy",
          "flight_number": "B6 123",
          "amenities": [
            "Above-average legroom (33 in)",
            "Free Wi-Fi",
            "Emissions estimate: 408 kg CO2e",
            "Contrail warming potential: Low"
          ]
        }
      ],
      "rank": 2
    },
    {
      "departure_time": "7:55 AM",
      "total_duration": "10 hr 28 min",
      "stops": 1,
      "total_emissions": "384 kg CO2e",
      "price": "$447",
      "price_raw": 447,
      "legs": [
        {
          "departure_airport": {
            "name": "LaGuardia Airport",
            "id": "LGA",
            "time": "7:55 AM"
          },
          "arrival_airport": {
            "name": "Charlotte Douglas International Airport",
            "id": "CLT",
            "time": "10:01 AM"
          },
          "duration": "2 hr 6 min",
          "overnight": false,
          "airplane": "Airbus A320",
          "airline": "American",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AA.png",
          "travel_class": "Economy",
          "flight_number": "AA 1023",
          "amenities": [
            "Average legroom (31 in)",
            "Free Wi-Fi",
            "Stream media to your device",
            "Emissions estimate: 106 kg CO2e",
            "Contrail warming potential: Low"
          ]
        },
        {
          "departure_airport": {
            "name": "Charlotte Douglas International Airport",
            "id": "CLT",
            "time": "1:20 PM"
          },
          "arrival_airport": {
            "name": "Los Angeles International Airport",
            "id": "LAX",
            "time": "3:23 PM"
          },
          "duration": "5 hr 3 min",
          "overnight": false,
          "airplane": "Airbus A321",
          "airline": "American",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AA.png",
          "travel_class": "Economy",
          "flight_number": "AA 352",
          "amenities": [
            "Average legroom (30 in)",
            "Free Wi-Fi",
            "Stream media to your device",
            "Emissions estimate: 279 kg CO2e",
            "Contrail warming potential: Low"
          ]
        }
      ],
      "rank": 3
    }
  ],
  "pagesProcessed": 1
}

PreviousExample Requests NextFeatures

Last updated 29 days ago