SEsearchapi

Google Flights Search

Changed on
get/search

Request

  • Base URL
    https://www.searchapi.io/api/v1
  • Auth
    • API key in header Authorization
    • or API key in query parameter api_key

Query parameters

engine'google_flights' required

Engine to use for the search

departure_idstring

Departure airport code or city ID (required unless flight_type is multi_city)

arrival_idstring

Arrival airport code or city ID (required unless flight_type is multi_city)

outbound_datestring

Outbound flight date in YYYY-MM-DD format (required unless flight_type is multi_city)

return_datestring

Return flight date in YYYY-MM-DD format (required for round_trip flights)

hl'af' | 'am' | 'ar' | 'bg' | 'bn' | 'bs' | 'ca' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'en-GB' | 'en-US' | 'es' | 'es-419' | 'et' | 'eu' | 'fa' | 'fi' | 'fil' | 'fr' | 'gl' | 'gu' | 'hi' | 'hr' | 'hu' | 'id' | 'is' | 'it' | 'iw' | 'ja' | 'ka' | 'km' | 'kn' | 'ko' | 'lo' | 'lt' | 'lv' | 'mk' | 'ml' | 'mn' | 'mr' | 'ms' | 'ne' | 'nl' | 'no' | 'pa' | 'pl' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'si' | 'sk' | 'sl' | 'sq' | 'sr' | 'sr-Latn' | 'sv' | 'sw' | 'ta' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'vi' | 'zh-CN' | 'zh-TW'

Language for the results

gl'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AG' | 'AR' | 'AM' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BT' | 'BO' | 'BA' | 'BW' | 'BR' | 'VG' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'CF' | 'TD' | 'CL' | 'CN' | 'CO' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'EE' | 'ET' | 'FJ' | 'FI' | 'FR' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GT' | 'GG' | 'GY' | 'HT' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LY' | 'LI' | 'LT' | 'LU' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MU' | 'MX' | 'FM' | 'MD' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'MK' | 'NO' | 'OM' | 'PK' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RO' | 'RU' | 'RW' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'KR' | 'ES' | 'LK' | 'SH' | 'VC' | 'SR' | 'SE' | 'CH' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'ZM' | 'ZW'

Country of the search

currency'ALL' | 'DZD' | 'ARS' | 'AMD' | 'AWG' | 'AUD' | 'AZN' | 'BSD' | 'BHD' | 'BYN' | 'BMD' | 'BAM' | 'BRL' | 'GBP' | 'BGN' | 'CAD' | 'XPF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUP' | 'CZK' | 'DKK' | 'DOP' | 'EGP' | 'EUR' | 'GEL' | 'HKD' | 'HUF' | 'ISK' | 'INR' | 'IDR' | 'IRR' | 'ILS' | 'JMD' | 'JPY' | 'JOD' | 'KZT' | 'KWD' | 'LBP' | 'MKD' | 'MYR' | 'MXN' | 'MDL' | 'MAD' | 'TWD' | 'NZD' | 'NOK' | 'OMR' | 'PKR' | 'PAB' | 'PEN' | 'PHP' | 'PLN' | 'QAR' | 'RON' | 'RUB' | 'SAR' | 'RSD' | 'SGD' | 'ZAR' | 'KRW' | 'SEK' | 'CHF' | 'THB' | 'TRY' | 'UAH' | 'AED' | 'USD' | 'VND'

Currency for prices

flight_type'round_trip' | 'one_way' | 'multi_city'

Type of flight search

stops'any' | 'nonstop' | 'one_stop_or_fewer' | 'two_stops_or_fewer'

Filter by number of stops

sort_by'top_flights' | 'price' | 'departure_time' | 'arrival_time' | 'duration' | 'emissions'

Sort order for results

travel_class'economy' | 'premium_economy' | 'business' | 'first_class'

Travel class preference

exclude_basic_economyboolean

Set to true to exclude Basic Economy fares. Supported only when travel_class is economy. Google Flights offers this filter for flights within the United States, its territories and Canada; other routes return the same results as without it.

adultsinteger

Number of adult passengers

childreninteger

Number of child passengers

infants_in_seatinteger

Number of infants with seat. A value above 0 may result in longer request processing times.

infants_on_lapinteger

Number of infants on lap. A value above 0 may result in longer request processing times.

max_priceinteger

Maximum price filter

carry_on_bagsinteger

Number of carry-on bags

checked_bagsinteger

Number of checked bags

included_airlinesstring

Comma-separated list of airline codes to include

excluded_airlinesstring

Comma-separated list of airline codes to exclude

included_connecting_airportsstring

Comma-separated list of connecting airport codes to include

excluded_connecting_airportsstring

Comma-separated list of connecting airport codes to exclude

outbound_timesstring

Comma-separated departure hour preferences (0-23)

return_timesstring

Comma-separated return hour preferences (0-23)

emissions'1'

Filter for less emissions only

layover_duration_mininteger

Minimum layover duration in minutes

layover_duration_maxinteger

Maximum layover duration in minutes

max_flight_durationinteger

Maximum flight duration in minutes

separate_tickets'0' | '1'

Show or hide separate tickets

departure_tokenstring

Token for pagination of search results

booking_tokenstring

Token for retrieving booking options

multi_city_jsonstring

JSON array of flight segments for multi-city trips

show_cheapest_flightsboolean

Show cheapest flights option

show_hidden_flightsboolean

Show hidden flights option

expanded_searchboolean

Set to true together with show_hidden_flights and/or show_cheapest_flights to retrieve more results, which may result in longer request processing times. It has no effect on its own.

Response

Successful response

errorstring

Error message if no results found

Changes

  • fb53a1a0eb07Revision changes
    • info

      added the new optional query request parameter exclude_basic_economy

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property / to the response with the status