GoogleFlights

Search Date Range for Best Prices

Version 2: fetch the cheapest starting option for from_date only. Continue with next_departure_date in a separately billed request.

get/flights/v2/date-range

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/flights/v2/date-range
  • Auth: API key in header X-API-KEY

Query parameters

originstring required

Origin airport IATA code

destinationstring required

Destination airport IATA code

adultsinteger nullable

Number of adult passengers (1-9, default: 1)

childreninteger nullable

Number of child passengers (0-9, default: 0)

infants_in_seatinteger nullable

Number of infants in seat (0-9, default: 0)

infants_on_lapinteger nullable

Number of infants on lap (0-9, default: 0)

cabin_class'economy' | 'premium_economy' | 'business' | 'first' | 'null' nullable

Cabin class: economy, premium_economy, business, or first (default: economy)

exclude_basicboolean nullable

Exclude basic economy fares when searching in economy class (default: false)

max_stops'any' | 'nonstop' | 'one_or_fewer' | 'two_or_fewer' | 'null' nullable

Maximum stops: any, nonstop, one_or_fewer, or two_or_fewer (default: any)

hlstring nullable

Language code (e.g., en, de, en-US)

glstring nullable

Country/region code (e.g., us, de, gb)

currencystring nullable

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

outbound_timesstring nullable

Outbound time window as comma-separated hours, e.g. "6,18" for departures between 06:00 and 18:00. Two further values narrow the arrival window.

bagsinteger nullable

Carry-on bag count. Only 0 is currently supported.

api_versioninteger
from_datestring date required

Start of date range in Y-m-d format

to_datestring date required

End of date range in Y-m-d format

trip_durationinteger nullable

Duration of trip in days (1-30, default: 7)

Response

Changes

No recorded changes to this operation across all 3 revisions of this API.