AviationService

SearchGoogleDates

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

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

Request

  • Base URL: https://api.worldmonitor.app
  • URL: https://api.worldmonitor.app/api/aviation/v1/search-google-dates
  • Auth: one of:
    • API key in header X-WorldMonitor-Key
    • API key in header X-Api-Key

Query parameters

originstring

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

destinationstring

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

start_datestring

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

end_datestring

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

trip_durationinteger

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

is_round_tripboolean

Whether to search for round-trip flights.

cabin_classstring

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

max_stopsstring

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

departure_windowstring

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

airlinesstring[]

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

sort_by_priceboolean

Whether to sort results by price (lowest first).

passengersinteger

Number of adult passengers (1-9).

jmespathstring

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

OK

degradedboolean
errorstring

Changes

No recorded changes to this operation across all 1 revision of this API.