Google Travel flights API

Search flights with prices and times

curl --request POST \
  --url https://api.stophy.dev/v1/googletravel/flights \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "origin": "JFK",
  "destination": "LAX",
  "departDate": "2026-11-12"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({origin: 'JFK', destination: 'LAX', departDate: '2026-11-12'})
};

fetch('https://api.stophy.dev/v1/googletravel/flights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/googletravel/flights"

payload = {
    "origin": "JFK",
    "destination": "LAX",
    "departDate": "2026-11-12"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "url": "<string>",
    "flights": [
      {
        "isBest": true,
        "stops": 0,
        "price": 123,
        "airlines": [
          "<string>"
        ],
        "durationSeconds": 0,
        "departureLocalTime": "<string>",
        "arrivalLocalTime": "<string>",
        "legs": [
          {
            "flightNumber": "<string>",
            "airline": "<string>",
            "origin": {
              "code": "<string>",
              "name": "<string>"
            },
            "destination": {
              "code": "<string>",
              "name": "<string>"
            },
            "departureLocalTime": "<string>",
            "arrivalLocalTime": "<string>",
            "durationSeconds": 0,
            "aircraft": "<string>",
            "legroom": "<string>"
          }
        ],
        "layovers": [
          {
            "airport": "<string>",
            "name": "<string>",
            "city": "<string>",
            "durationSeconds": 0
          }
        ],
        "emissionsGrams": 0,
        "typicalEmissionsGrams": 0
      }
    ],
    "currency": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123
  }
}

POST

googletravel

flights

Search flights with prices and times

curl --request POST \
  --url https://api.stophy.dev/v1/googletravel/flights \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "origin": "JFK",
  "destination": "LAX",
  "departDate": "2026-11-12"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({origin: 'JFK', destination: 'LAX', departDate: '2026-11-12'})
};

fetch('https://api.stophy.dev/v1/googletravel/flights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/googletravel/flights"

payload = {
    "origin": "JFK",
    "destination": "LAX",
    "departDate": "2026-11-12"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "url": "<string>",
    "flights": [
      {
        "isBest": true,
        "stops": 0,
        "price": 123,
        "airlines": [
          "<string>"
        ],
        "durationSeconds": 0,
        "departureLocalTime": "<string>",
        "arrivalLocalTime": "<string>",
        "legs": [
          {
            "flightNumber": "<string>",
            "airline": "<string>",
            "origin": {
              "code": "<string>",
              "name": "<string>"
            },
            "destination": {
              "code": "<string>",
              "name": "<string>"
            },
            "departureLocalTime": "<string>",
            "arrivalLocalTime": "<string>",
            "durationSeconds": 0,
            "aircraft": "<string>",
            "legroom": "<string>"
          }
        ],
        "layovers": [
          {
            "airport": "<string>",
            "name": "<string>",
            "city": "<string>",
            "durationSeconds": 0
          }
        ],
        "emissionsGrams": 0,
        "typicalEmissionsGrams": 0
      }
    ],
    "currency": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123
  }
}

Endpoint: googletravel.flights
Returns: data has url, currency, flights.
Cost: 3 credits. Failed calls cost nothing.
Paging: No.

Example

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.googletravel.flights({ origin: "JFK", destination: "LAX", departDate: "2026-11-12" });
console.log(result.data.flights);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.googletravel.flights(origin="JFK", destination="LAX", depart_date="2026-11-12")
print(result["data"]["flights"])

curl -X POST https://api.stophy.dev/v1/googletravel/flights \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"origin":"JFK","destination":"LAX","departDate":"2026-11-12"}'

stophy googletravel flights --origin JFK --destination LAX --departDate 2026-11-12

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

origin

string

required

IATA airport code, e.g. JFK. Any case is accepted.

Pattern: ^[A-Za-z]{3}$

destination

string

required

IATA airport code, e.g. JFK. Any case is accepted.

Pattern: ^[A-Za-z]{3}$

departDate

string

required

Pattern: ^\d{4}-\d{2}-\d{2}$

returnDate

string

Pattern: ^\d{4}-\d{2}-\d{2}$

adults

integer

default:1

Required range: 1 <= x <= 9

children

integer

default:0

Required range: 0 <= x <= 8

cabin

enum<string>

default:economy

Available options:

economy,

premiumEconomy,

business,

first

maxStops

integer

Required range: 0 <= x <= 2

currency

string

default:USD

language

string

default:en

BCP 47 language tag, e.g. en or pt-BR. Any case is accepted.

Pattern: ^[A-Za-z]{2,3}(?:[-_][A-Za-z0-9]{2,4})?$

Response

The data, and the credits this call used.

success

any

required

data

object

required

Show child attributes

creditsUsed

integer

required

requestId

string

required

Using the API

Catalog

Account

Web search and pages

Video

Social

Places and travel

Shopping

Apps

Jobs

Real estate

Ads

Finance and crypto

Google Travel flights API

Example

Authorizations

Body

Response

​Example

Authorizations

Body

Response

Example