GoogleFlights

Search Round-Trip Flights

Version 2: fetch outbound starting prices, then pass departure_token to fetch matching returns in a separate paid request.

get/flights/v2/round-trip

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/flights/v2/round-trip
  • 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)

childreninteger nullable

Number of child passengers (0-9)

infants_in_seatinteger nullable

Number of infants in seat (0-9)

infants_on_lapinteger nullable

Number of infants on lap (0-9)

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

Cabin class: economy, premium_economy, business, or first

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, two_or_fewer

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)

bagsinteger nullable

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

api_versioninteger
departure_datestring date required

Departure date in Y-m-d format

return_datestring date required

Return date in Y-m-d format

sort_by'top_flights' | 'cheapest' | 'departure_time' | 'arrival_time' | 'duration' | 'emissions' | 'null' nullable

Sort results by: top_flights, cheapest, departure_time, arrival_time, duration

airlines[]string[]

Filter by airline IATA codes (e.g., ["AA", "UA", "DL"] or "AA,UA,DL")

include_baggageboolean

Only false/0 is supported. No additional baggage lookup is performed.

departure_tokenstring nullable

Copy one token from the outbound response and repeat the same search parameters to request its matching returns. Maximum 16384 characters.

departure_time_mininteger nullable

Minimum departure hour (0-23). Use with departure_time_max to filter by time range.

departure_time_maxinteger nullable

Maximum departure hour (0-23). Use with departure_time_min to filter by time range.

arrival_time_mininteger nullable

Minimum arrival hour (0-23). Use with arrival_time_max to filter by time range.

arrival_time_maxinteger nullable

Maximum arrival hour (0-23). Use with arrival_time_min to filter by time range.

max_duration_minutesinteger nullable

Maximum flight duration in minutes. Filters out flights longer than this.

max_priceinteger nullable

Maximum price in the search currency. Filters out flights more expensive than this.

Response

Changes

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