Google Flights API

{
  "additionalProperties": false,
  "properties": {
    "query": {
      "additionalProperties": false,
      "properties": {
        "adults": {
          "description": "Parameter defines the number of adults. Default to 1.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "arrival_id": {
          "description": "Parameter defines the arrival airport code or location kgmid. An airport code is an uppercase 3-letter code. You can search for it on [Google Flights](https://www.google.com/travel/flights) or [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `CDG` is Paris Charles de Gaulle Airport and `AUS` is Austin-Bergstrom International Airport. A location kgmid is a string t",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "async": {
          "description": "Parameter defines the way you want to submit your search to SerpApi. It can be set to `false` (default) to open an HTTP connection and keep it open until you got your search results, or `true` to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our [Searches Archive API](https://Asale.com/search-archive-api) to retrieve your results. `async` and `no_ca",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "bags": {
          "description": "Parameter defines the number of carry-on bags. Default to `0`. Parameter should not exceed the total number of passengers with carry-on bag allowance (`adults`, `children` and `infants_in_seat`).",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "booking_token": {
          "description": "Parameter is used to get booking options for the selected flights. Find this token in the flight results. It cannot be used together with `departure_token`. When using this token, parameters related to date and parameters inside \"Advanced Filters\" section won't affect the result.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "children": {
          "description": "Parameter defines the number of children. Default to 0.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "currency": {
          "description": "Parameter defines the currency of the returned prices. Default to `USD`. Head to the [Google Travel Currencies page](https://Asale.com/google-travel-currencies) for a full list of supported currency codes.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "deep_search": {
          "description": "Set to `true` to enable deep search, which may yield better results but with a longer response time. Deep search results are identical to those found on Google Flights pages in the browser. By default, this option is set to `false` for performance reasons.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "departure_id": {
          "description": "Parameter defines the departure airport code or location kgmid. An airport code is an uppercase 3-letter code. You can search for it on [Google Flights](https://www.google.com/travel/flights) or [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `CDG` is Paris Charles de Gaulle Airport and `AUS` is Austin-Bergstrom International Airport. A location kgmid is a string",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "departure_token": {
          "description": "Parameter is used to select the flight and get returning flights (for Round trip) or flights for the next leg of itinerary (for Multi-city). Find this token in the departure flight results. It cannot be used together with `booking_token`.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "emissions": {
          "description": "Parameter defines the emission level of the flight. Available options: `1` - Less emissions only",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "exclude_airlines": {
          "description": "Parameter defines the airline codes to be excluded. Split multiple airlines with comma. It can't be used together with `include_airlines`. Each airline code should be a 2-character IATA code consisting of either two uppercase letters or one uppercase letter and one digit. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "exclude_basic": {
          "description": "Set to `true` to exclude basic results. Resulting fares will have free seat selection and carry on bags. Default to `false`. As of now, this filter only works for domestic flights in the US. Parameter can only be used when `gl` is`us` and `travel_class` is`1`",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "exclude_conns": {
          "description": "Parameter defines the connecting airport codes to be excluded. An airport ID is an uppercase 3-letter code. You can search for it on [Google Flights](https://www.google.com/travel/flights) or [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `CDG` is Paris Charles de Gaulle Airport and `AUS` is Austin-Bergstrom International Airport. You can also combine multiple",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "gl": {
          "description": "Parameter defines the country to use for the Google Flights search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France) Head to the [Google countries page](https://Asale.com/google-countries) for a full list of supported Google countries.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "hl": {
          "description": "Parameter defines the language to use for the Google Flights search. It's a two or three-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French), optionally followed by a two-letter or three-digit region code (e.g., `en-gb` for British English, or `es-419` for Latin American Spanish). Head to the [Google languages page](https://Asale.com/google-languages) for a full",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "include_airlines": {
          "description": "Parameter defines the airline codes to be included. Split multiple airlines with comma. It can't be used together with `exclude_airlines`. Each airline code should be a 2-character IATA code consisting of either two uppercase letters or one uppercase letter and one digit. You can search for airline codes on [IATA](https://www.iata.org/en/publications/directories/code-search). For example, `UA` is",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "infants_in_seat": {
          "description": "Parameter defines the number of infants in seat. Default to 0.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "infants_on_lap": {
          "description": "Parameter defines the number of infants on lap. Default to 0.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "json_restrictor": {
          "description": "Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the [JSON Restrictor documentation](https://Asale.com/json-restrictor) for more details.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "layover_duration": {
          "description": "Parameter defines the layover duration, in minutes. It's a string containing two comma-separated numbers. For example, specify `90,330` for 1 hr 30 min - 5 hr 30 min.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "max_duration": {
          "description": "Parameter defines the maximum flight duration, in minutes. For example, specify `1500` for 25 hours. If your search returns no results, try increasing your `max_duration` by up to `200` minutes to account for route-specific scheduling variances.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "max_price": {
          "description": "Parameter defines the maximum ticket price. Default to unlimited.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "multi_city_json": {
          "description": "Parameter defines the flight information for multi-city flights. It's a JSON string containing multiple flight information objects. Each object should contain the following fields: `departure_id` - The departure airport code or location kgmid. The format is the same as the main [departure_id](https://Asale.com/google-flights-api#api-parameters-search-query-departure-id) parameter. `arrival_id`",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "no_cache": {
          "description": "Parameter will force SerpApi to fetch the Google Flights results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to `false` (default) to allow results from the cache, or `true` to disallow results from the cac",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "outbound_date": {
          "description": "Parameter defines the outbound date. The format is YYYY-MM-DD. e.g. `2026-09-14` Parameter is required when `type` is `1` (Round trip) or `2` (One way), unless `selected_flights_json` is used. Parameter can't be used when `type` is `3` (Multi-city). Use `date` inside `multi_city_json` instead.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "outbound_times": {
          "description": "Parameter defines the outbound times range. It's a string containing two (for departure only) or four (for departure and arrival) comma-separated numbers. Each number represents the beginning of an hour. For example: `4,18`: 4:00 AM - 7:00 PM departure `0,18`: 12:00 AM - 7:00 PM departure `19,23`: 7:00 PM - 12:00 AM departure `4,18,3,19`: 4:00 AM - 7:00 PM departure, 3:00 AM - 8:00 PM arrival `0,",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "output": {
          "description": "Parameter defines the format of the result. It can be set to `json` (default) to get a structured JSON of the results, `html` to get the raw HTML retrieved, or `md` to get a markdown-formatted version optimized for LLMs and AI agents.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "return_date": {
          "description": "Parameter defines the return date. The format is YYYY-MM-DD. e.g. `2026-09-20` Parameter is required when `type` is `1` (Round trip), unless `selected_flights_json` is used. Parameter can't be used when `type` is `2` (One way) or `3` (Multi-city).",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "return_times": {
          "description": "Parameter defines the return times range. It's a string containing two (for departure only) or four (for departure and arrival) comma-separated numbers. Each number represents the beginning of an hour. For example: `4,18`: 4:00 AM - 7:00 PM departure `0,18`: 12:00 AM - 7:00 PM departure `19,23`: 7:00 PM - 12:00 AM departure `4,18,3,19`: 4:00 AM - 7:00 PM departure, 3:00 AM - 8:00 PM arrival `0,23",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "selected_flights_json": {
          "description": "Parameter pins the itinerary to specific flights, segment by segment. It's a JSON object with an `outbound` key (required) and a `return` key (required for round-trip, forbidden for one-way). Each value is an ordered array of flight segment objects, each containing: `flight_number` - IATA flight number (2-character airline code + 1–4 digits, e.g. `BA591`). `departure_id` - 3-letter IATA airport c",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "show_hidden": {
          "description": "Set to `true` to include the hidden flight results. This is equivalent to clicking 'View more flights' on Google Flights. Default to `false`.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "sort_by": {
          "description": "Parameter defines the sorting order of the results. Available options: `1` - Top flights (default) `2` - Price `3` - Departure time `4` - Arrival time `5` - Duration `6` - Emissions",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "stops": {
          "description": "Parameter defines the number of stops during the flight. Available options: `0` - Any number of stops (default) `1` - Nonstop only `2` - 1 stop or fewer `3` - 2 stops or fewer",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "travel_class": {
          "description": "Parameter defines the travel class. Available options: `1` - Economy (default) `2` - Premium economy `3` - Business `4` - First",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "type": {
          "description": "Parameter defines the type of the flights. Available options: `1` - Round trip (default) `2` - One way `3` - Multi-city When this parameter is set to `3`, use `multi_city_json` to set the flight information. To obtain the returning flight information for Round Trip `(1)`, you need to make another request using a [departure_token](#api-parameters-next-flights).",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "zero_trace": {
          "description": "Enterprise only. Parameter enables [ZeroTrace mode](https://Asale.com/zero-trace-mode). It can be set to `false` (default) or `true`. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        }
      },
      "required": [],
      "type": "object"
    }
  },
  "required": [],
  "type": "object"
}