{
  "name": "searchapi_google_flights",
  "description": "Google Flights results from SearchApi, as structured JSON.",
  "input_schema": {
    "type": "object",
    "properties": {
      "departure_id": {
        "type": "string",
        "description": "Departure airport IATA code or location kgmid, e.g. JFK."
      },
      "arrival_id": {
        "type": "string",
        "description": "Arrival airport IATA code or location kgmid, e.g. LHR."
      },
      "outbound_date": {
        "type": "string",
        "description": "Outbound flight date (YYYY-MM-DD)."
      },
      "return_date": {
        "type": "string",
        "description": "Return flight date (YYYY-MM-DD); required for round trips."
      },
      "flight_type": {
        "type": "string",
        "description": "Type of the flight search.",
        "enum": [
          "round_trip",
          "one_way",
          "multi_city"
        ],
        "default": "round_trip"
      },
      "travel_class": {
        "type": "string",
        "description": "Cabin class.",
        "enum": [
          "economy",
          "premium_economy",
          "business",
          "first"
        ],
        "default": "economy"
      },
      "adults": {
        "type": "integer",
        "description": "Number of adult passengers.",
        "default": 1
      },
      "children": {
        "type": "integer",
        "description": "Number of child passengers.",
        "default": 0
      },
      "stops": {
        "type": "string",
        "description": "Maximum number of stops filter."
      },
      "currency": {
        "type": "string",
        "description": "Currency of the returned prices (ISO 4217 code).",
        "default": "USD"
      },
      "gl": {
        "type": "string",
        "description": "Country of the search (two-letter country code).",
        "enum": [
          "af",
          "al",
          "dz",
          "as",
          "ad",
          "ao",
          "ai",
          "aq",
          "ag",
          "ar",
          "am",
          "aw",
          "au",
          "at",
          "az",
          "bs",
          "bh",
          "bd",
          "bb",
          "by",
          "be",
          "bz",
          "bj",
          "bm",
          "bt",
          "bo",
          "ba",
          "bw",
          "bv",
          "br",
          "io",
          "bn",
          "bg",
          "bf",
          "bi",
          "kh",
          "cm",
          "ca",
          "cv",
          "ky",
          "cf",
          "td",
          "cl",
          "cn",
          "cx",
          "cc",
          "co",
          "km",
          "cg",
          "cd",
          "ck",
          "cr",
          "ci",
          "hr",
          "cu",
          "cy",
          "cz",
          "dk",
          "dj",
          "dm",
          "do",
          "ec",
          "eg",
          "sv",
          "gq",
          "er",
          "ee",
          "et",
          "fk",
          "fo",
          "fj",
          "fi",
          "fr",
          "gf",
          "pf",
          "tf",
          "ga",
          "gm",
          "ge",
          "de",
          "gh",
          "gi",
          "gr",
          "gl",
          "gd",
          "gp",
          "gu",
          "gt",
          "gn",
          "gw",
          "gy",
          "ht",
          "hm",
          "va",
          "hn",
          "hk",
          "hu",
          "is",
          "in",
          "id",
          "ir",
          "iq",
          "ie",
          "il",
          "it",
          "jm",
          "jp",
          "jo",
          "kz",
          "ke",
          "ki",
          "kp",
          "kr",
          "kw",
          "kg",
          "la",
          "lv",
          "lb",
          "ls",
          "lr",
          "ly",
          "li",
          "lt",
          "lu",
          "mo",
          "mk",
          "mg",
          "mw",
          "my",
          "mv",
          "ml",
          "mt",
          "mh",
          "mq",
          "mr",
          "mu",
          "yt",
          "mx",
          "fm",
          "md",
          "mc",
          "mn",
          "ms",
          "ma",
          "mz",
          "mm",
          "na",
          "nr",
          "np",
          "nl",
          "an",
          "nc",
          "nz",
          "ni",
          "ne",
          "ng",
          "nu",
          "nf",
          "mp",
          "no",
          "om",
          "pk",
          "pw",
          "ps",
          "pa",
          "pg",
          "py",
          "pe",
          "ph",
          "pn",
          "pl",
          "pt",
          "pr",
          "qa",
          "re",
          "ro",
          "ru",
          "rw",
          "sh",
          "kn",
          "lc",
          "pm",
          "vc",
          "ws",
          "sm",
          "st",
          "sa",
          "sn",
          "rs",
          "sc",
          "sl",
          "sg",
          "sk",
          "si",
          "sb",
          "so",
          "za",
          "gs",
          "es",
          "lk",
          "sd",
          "sr",
          "sj",
          "sz",
          "se",
          "ch",
          "sy",
          "tw",
          "tj",
          "tz",
          "th",
          "tg",
          "tk",
          "to",
          "tt",
          "tn",
          "tr",
          "tm",
          "tc",
          "tv",
          "ug",
          "ua",
          "ae",
          "uk",
          "gb",
          "us",
          "um",
          "uy",
          "uz",
          "vu",
          "ve",
          "vn",
          "vg",
          "vi",
          "wf",
          "eh",
          "ye",
          "zm",
          "zw"
        ],
        "default": "us"
      },
      "hl": {
        "type": "string",
        "description": "Interface language of the search (two-letter language code).",
        "enum": [
          "af",
          "ak",
          "sq",
          "am",
          "ar",
          "hy",
          "az",
          "eu",
          "be",
          "bem",
          "bn",
          "bh",
          "bs",
          "br",
          "bg",
          "km",
          "ca",
          "chr",
          "ny",
          "zh-CN",
          "zh-TW",
          "co",
          "hr",
          "cs",
          "da",
          "nl",
          "en",
          "eo",
          "et",
          "ee",
          "fo",
          "tl",
          "fi",
          "fr",
          "fy",
          "gaa",
          "gl",
          "ka",
          "de",
          "el",
          "gn",
          "gu",
          "ht",
          "ha",
          "haw",
          "iw",
          "hi",
          "hu",
          "is",
          "ig",
          "id",
          "ia",
          "ga",
          "it",
          "ja",
          "jw",
          "kn",
          "kk",
          "rw",
          "rn",
          "kg",
          "ko",
          "kri",
          "ku",
          "ckb",
          "ky",
          "lo",
          "la",
          "lv",
          "ln",
          "lt",
          "loz",
          "lg",
          "ach",
          "mk",
          "mg",
          "ms",
          "ml",
          "mt",
          "mi",
          "mr",
          "mfe",
          "mo",
          "mn",
          "sr-ME",
          "my",
          "ne",
          "pcm",
          "nso",
          "no",
          "nn",
          "oc",
          "or",
          "om",
          "ps",
          "fa",
          "pl",
          "pt",
          "pt-BR",
          "pt-PT",
          "pa",
          "qu",
          "ro",
          "rm",
          "nyn",
          "ru",
          "gd",
          "sr",
          "sh",
          "st",
          "tn",
          "crs",
          "sn",
          "sd",
          "si",
          "sk",
          "sl",
          "so",
          "es",
          "es-419",
          "su",
          "sw",
          "sv",
          "tg",
          "ta",
          "tt",
          "te",
          "th",
          "ti",
          "to",
          "lua",
          "tum",
          "tr",
          "tk",
          "tw",
          "ug",
          "uk",
          "ur",
          "uz",
          "vi",
          "cy",
          "wo",
          "xh",
          "yi",
          "yo",
          "zu"
        ],
        "default": "en"
      }
    },
    "required": [
      "departure_id",
      "arrival_id",
      "outbound_date"
    ],
    "examples": [
      {
        "departure_id": "sample_google_flights_departure_id",
        "arrival_id": "sample_google_flights_arrival_id",
        "outbound_date": "2026-09-01"
      }
    ]
  }
}