SearchGoogleDates

SearchGoogleDates finds the cheapest travel dates across a flexible date range via Google Flights.

GET /api/aviation/v1/search-google-dates

SearchGoogleDates

cURL

curl --request GET \
  --url https://api.example.com/api/aviation/v1/search-google-dates

200

{
  "dates": [
    {
      "date": "<string>",
      "returnDate": "<string>",
      "price": 123
    }
  ],
  "degraded": true,
  "error": "<string>"
}

Query Parameters

origin · string

Departure airport IATA code (e.g. "JFK").

destination · string

Arrival airport IATA code (e.g. "LHR").

start_date · string

Start of date range in YYYY-MM-DD format.

end_date · string

End of date range in YYYY-MM-DD format.

trip_duration · integer<int32>

Trip duration in days (required for round-trip searches).

is_round_trip · boolean

Whether to search for round-trip flights.

cabin_class · string

Cabin class: ECONOMY, PREMIUM_ECONOMY, BUSINESS, or FIRST.

max_stops · string

Stop filter: ANY, NON_STOP, ONE_STOP, or TWO_PLUS_STOPS.

departure_window · string

Departure time window in HH-HH format (e.g. "6-20").

airlines · string

Airline IATA codes to filter by (e.g. ["BA", "AA"]).

sort_by_price · boolean

Whether to sort results by price (lowest first).

passengers · integer<int32>

Number of adult passengers (1-9).

Response

200

application/json

Successful response

SearchGoogleDatesResponse contains cheapest-date results from Google Flights.

dates · object[]

Show child attributes

degraded · boolean

error · string