Google Flights Search (Real-Time Fares)

Previous value: -"One entry per traveller, not a count: 1 adult, 2 child (aged 2-11), 3 infant on lap, 4 infant in seat, e.g. [1, 1, 2] for two adults and a child. At least one adult, each infant on lap needs its own adult, at most 9. Omit for one adult."New value: +"One entry per traveller, not a count: 1 adult, 2 child (aged 2-11), 3 infant on lap, 4 infant in seat, e.g. [1, 1, 2] for two adults and a child. At least one adult, each infant on lap needs its own adult, at most 9. Omit for one adult. A counts list [adults, children, infants], e.g. [2, 1, 0], or a bare [2] for two adults, is recognised and converted to codes before the search; a list that is valid as codes is searched as codes."

Previous value: -"One entry per traveller, not a count: 1 adult, 2 child (aged 2-11), 3 infant on lap, 4 infant in seat, e.g. [1, 1, 2] for two adults and a child. At least one adult, each infant on lap needs its own adult, at most 9. Omit for one adult."New value: +"One entry per traveller, not a count: 1 adult, 2 child (aged 2-11), 3 infant on lap, 4 infant in seat, e.g. [1, 1, 2] for two adults and a child. At least one adult, each infant on lap needs its own adult, at most 9. Omit for one adult. A counts list [adults, children, infants], e.g. [2, 1, 0], or a bare [2] for two adults, is recognised and converted to codes before the search; a list that is valid as codes is searched as codes."

Previous value: -"Passenger counts as [adults, children, infants]."New value: +"One entry per traveller, not a count: 1 adult, 2 child (aged 2-11), 3 infant on lap, 4 infant in seat, e.g. [1, 1, 2] for two adults and a child. At least one adult, each infant on lap needs its own adult, at most 9. Omit for one adult."

Previous value: -"Passenger counts as [adults, children, infants]."New value: +"One entry per traveller, not a count: 1 adult, 2 child (aged 2-11), 3 infant on lap, 4 infant in seat, e.g. [1, 1, 2] for two adults and a child. At least one adult, each infant on lap needs its own adult, at most 9. Omit for one adult."

Added value: +{
+  "default": false,
+  "description": "Return every field the upstream sends on each fare, and every fare that was selected, with no row bound. Off by default: a result carries the best rows by your sort_by in a compact shape (dates, destination, airline, stops, duration, price, trip length and the booking link), because a wide search over a month and several destinations otherwise produces a megabyte of JSON that some hosts refuse to put in the conversation at all. Turn it on when you need the arrival times, the per-leg stop counts, the raw stop details or more rows than results_returned; results_total always says how many there were.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "How many of this destination's fares were selected. Not all of them are necessarily in `results`: a wide search returns the top results_returned of results_total overall, and `cheapest` below is this destination's own best fare either way.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +"Only on `verbose: true`: this destination's selected rows, the same objects that are in `results`."

Previous value: -[
-  "rows",
-  "searched",
-  "reason"
-]New value: +[
+  "row_count",
+  "searched",
+  "reason"
+]

Previous value: -"One entry per destination the REQUEST asked for, in request order, present whether or not that destination has any flights in `results`. A destination with an empty `rows` array is a hole in the answer, and `reason` says which kind of hole: 'no_flights' (searched, answered, Google has nothing), 'search_failed' (searched and the search errored, so nothing is known), 'not_in_limit' (searched, found flights, none fitted in `limit`) or 'not_searched' (never searched -- the per-call fan-out cap sampled it away). 'ok' means it has rows.\n\nRead this rather than inferring coverage from `results`: a destination missing from `results` looks identical to one that has no flights, and they are not the same answer. `rows` are the same row objects that are in `results`, in the same order -- nothing here is data the answer does not already contain."New value: +"One entry per destination the REQUEST asked for, in request order, present whether or not that destination has any flights in `results`. A destination with an empty `rows` array is a hole in the answer, and `reason` says which kind of hole: 'no_flights' (searched, answered, Google has nothing), 'search_failed' (searched and the search errored, so nothing is known), 'not_in_limit' (searched, found flights, none fitted in `limit`) or 'not_searched' (never searched -- the per-call fan-out cap sampled it away). 'ok' means it has rows.\n\nRead this rather than inferring coverage from `results`: a destination missing from `results` looks identical to one that has no flights, and they are not the same answer. `row_count` is how many of this destination's fares were selected; the fares themselves are in `results` and are not repeated here. `verbose: true` restores the `rows` array for callers that read it."

Added value: +{
+  "description": "The origin, as the upstream renders it ('Tel Aviv (TLV)'). One origin per search, so it is on the response rather than repeated on every row.",
+  "type": "string"
+}

Added value: +"How many rows are in `results`; same as results_returned."

Previous value: -"The itineraries or properties found, already sorted and deduplicated. An empty array is only meaningful when search_status is 'empty'."New value: +"The fares found, already sorted and deduplicated. An empty array is only meaningful when search_status is 'empty'.\n\nThis is the TOP results_returned of results_total rows by the sort you asked for -- cheapest first by default, shortest first on sort_by 'duration' -- with every destination that has fares still represented. Each row is in a compact shape: destination, the date or dates, trip length in nights on a round trip, airline (both legs on a round trip), stops, duration, the price as a string and a number, Google's price band with its verdict, and the booking link. The origin is on the response as from_airport rather than repeated on every row. Arrival descriptions, per-leg stop counts, raw stop details and the duration in seconds are dropped; `verbose: true` returns them, and every row that was selected, on that call."

Added value: +{
+  "description": "How many of them are in `results` -- the best ones by the sort_by asked for, cheapest first by default, and never all of one destination at the expense of another. Lower than results_total only when `limit` was raised by the server to cover the fan-out rather than asked for; search_coverage.note says so when it happens, and `verbose: true` returns them all.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "How many fares the search selected across every searched combination, before any row bound. Equal to results_returned unless the server bounded a response it had widened itself.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "default": false,
+  "description": "Return every field the upstream sends on each fare, and every fare that was selected, with no row bound. Off by default: a result carries the best rows by your sort_by in a compact shape (dates, destination, airline, stops, duration, price, trip length and the booking link), because a wide search over a month and several destinations otherwise produces a megabyte of JSON that some hosts refuse to put in the conversation at all. Turn it on when you need the arrival times, the per-leg stop counts, the raw stop details or more rows than results_returned; results_total always says how many there were.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "How many of this destination's fares were selected. Not all of them are necessarily in `results`: a wide search returns the top results_returned of results_total overall, and `cheapest` below is this destination's own best fare either way.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +"Only on `verbose: true`: this destination's selected rows, the same objects that are in `results`."

Previous value: -[
-  "rows",
-  "searched",
-  "reason"
-]New value: +[
+  "row_count",
+  "searched",
+  "reason"
+]

Previous value: -"One entry per destination the REQUEST asked for, in request order, present whether or not that destination has any flights in `results`. A destination with an empty `rows` array is a hole in the answer, and `reason` says which kind of hole: 'no_flights' (searched, answered, Google has nothing), 'search_failed' (searched and the search errored, so nothing is known), 'not_in_limit' (searched, found flights, none fitted in `limit`) or 'not_searched' (never searched -- the per-call fan-out cap sampled it away). 'ok' means it has rows.\n\nRead this rather than inferring coverage from `results`: a destination missing from `results` looks identical to one that has no flights, and they are not the same answer. `rows` are the same row objects that are in `results`, in the same order -- nothing here is data the answer does not already contain."New value: +"One entry per destination the REQUEST asked for, in request order, present whether or not that destination has any flights in `results`. A destination with an empty `rows` array is a hole in the answer, and `reason` says which kind of hole: 'no_flights' (searched, answered, Google has nothing), 'search_failed' (searched and the search errored, so nothing is known), 'not_in_limit' (searched, found flights, none fitted in `limit`) or 'not_searched' (never searched -- the per-call fan-out cap sampled it away). 'ok' means it has rows.\n\nRead this rather than inferring coverage from `results`: a destination missing from `results` looks identical to one that has no flights, and they are not the same answer. `row_count` is how many of this destination's fares were selected; the fares themselves are in `results` and are not repeated here. `verbose: true` restores the `rows` array for callers that read it."

Added value: +{
+  "description": "The origin, as the upstream renders it ('Tel Aviv (TLV)'). One origin per search, so it is on the response rather than repeated on every row.",
+  "type": "string"
+}

Added value: +"How many rows are in `results`; same as results_returned."

Previous value: -"The itineraries or properties found, already sorted and deduplicated. An empty array is only meaningful when search_status is 'empty'."New value: +"The fares found, already sorted and deduplicated. An empty array is only meaningful when search_status is 'empty'.\n\nThis is the TOP results_returned of results_total rows by the sort you asked for -- cheapest first by default, shortest first on sort_by 'duration' -- with every destination that has fares still represented. Each row is in a compact shape: destination, the date or dates, trip length in nights on a round trip, airline (both legs on a round trip), stops, duration, the price as a string and a number, Google's price band with its verdict, and the booking link. The origin is on the response as from_airport rather than repeated on every row. Arrival descriptions, per-leg stop counts, raw stop details and the duration in seconds are dropped; `verbose: true` returns them, and every row that was selected, on that call."

Added value: +{
+  "description": "How many of them are in `results` -- the best ones by the sort_by asked for, cheapest first by default, and never all of one destination at the expense of another. Lower than results_total only when `limit` was raised by the server to cover the fan-out rather than asked for; search_coverage.note says so when it happens, and `verbose: true` returns them all.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "How many fares the search selected across every searched combination, before any row bound. Equal to results_returned unless the server bounded a response it had widened itself.",
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -"The billed requests this call may make, up or down. Leave it out for the normal behaviour: the cap covers the request when the request is reasonable (a whole month at three trip lengths, 93 combinations, runs in full) and anything past it is sampled evenly across the range rather than cut short. Set it lower to spend less of the plan's quota on a wide search, or higher -- to a hard maximum of 200 -- for a grid wider than that."New value: +"The billed requests this call may make, up or down. Leave it out for the normal behaviour: the cap covers the request when the request is reasonable (a whole month at three trip lengths is 93 combinations and a whole month x 3 nights x 3 destinations is 279; both run in full) and anything past it is sampled evenly across the range rather than cut short. Set it lower to spend less of the plan's quota on a wide search, or higher -- to a hard maximum of 300 -- for a grid wider than that."

Previous value: -"The billed requests this call may make, up or down. Leave it out for the normal behaviour: the cap covers the request when the request is reasonable (a whole month at three trip lengths, 93 combinations, runs in full) and anything past it is sampled evenly across the range rather than cut short. Set it lower to spend less of the plan's quota on a wide search, or higher -- to a hard maximum of 200 -- for a grid wider than that."New value: +"The billed requests this call may make, up or down. Leave it out for the normal behaviour: the cap covers the request when the request is reasonable (a whole month at three trip lengths is 93 combinations and a whole month x 3 nights x 3 destinations is 279; both run in full) and anything past it is sampled evenly across the range rather than cut short. Set it lower to spend less of the plan's quota on a wide search, or higher -- to a hard maximum of 300 -- for a grid wider than that."

Previous value: -"Cap the billed requests this call may make. Lower it to spend less of the plan's quota on a wide search; the range is then sampled evenly rather than cut short."New value: +"The billed requests this call may make, up or down. Leave it out for the normal behaviour: the cap covers the request when the request is reasonable (a whole month at three trip lengths, 93 combinations, runs in full) and anything past it is sampled evenly across the range rather than cut short. Set it lower to spend less of the plan's quota on a wide search, or higher -- to a hard maximum of 200 -- for a grid wider than that."

Added value: +{
+  "description": "How many HTTP requests RapidAPI actually billed. Larger than requests_used_by_this_call when a search failed with a server error and was retried, because the retry is billed too. This is the figure the invoice will show.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +"How many date/destination combinations were searched -- what the answer COVERS."

Added value: +{
+  "description": "HTTP requests billed by RapidAPI for this call, retries included; see api_usage.hub_requests_billed.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "Present when something other than the cap ended the fan-out. 'deadline': the call reached its time limit and the remaining combinations were never sent or billed, so the results are real but do not cover the whole range.",
+  "type": "string"
+}

Previous value: -"Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry. 'trial_exhausted': the free signed-in allowance on this server is spent for today, so nothing was searched and nothing was billed; it renews at 00:00 UTC and connecting your own RapidAPI key removes the cap. Retrying does not help."New value: +"Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry. 'trial_exhausted': the free signed-in allowance on this server is spent for today, so nothing was searched and nothing was billed; it renews at 00:00 UTC and connecting your own RapidAPI key removes the cap. Retrying does not help. 'quota_exceeded': the search was refused because the caller's remaining allowance or plan quota cannot cover the number of combinations asked for; combos_requested and combos_allowed_now carry the two numbers. Nothing was searched beyond what it cost to read the quota. Retrying the same search does not help -- ask for fewer dates or nights, or move to a larger plan."

Previous value: -[
-  "ok",
-  "empty",
-  "partial",
-  "degraded",
-  "trial_exhausted"
-]New value: +[
+  "ok",
+  "empty",
+  "partial",
+  "degraded",
+  "trial_exhausted",
+  "quota_exceeded"
+]

Previous value: -"Cap the billed requests this call may make. Lower it to spend less of the plan's quota on a wide search; the range is then sampled evenly rather than cut short."New value: +"The billed requests this call may make, up or down. Leave it out for the normal behaviour: the cap covers the request when the request is reasonable (a whole month at three trip lengths, 93 combinations, runs in full) and anything past it is sampled evenly across the range rather than cut short. Set it lower to spend less of the plan's quota on a wide search, or higher -- to a hard maximum of 200 -- for a grid wider than that."

Added value: +{
+  "description": "How many HTTP requests RapidAPI actually billed. Larger than requests_used_by_this_call when a search failed with a server error and was retried, because the retry is billed too. This is the figure the invoice will show.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +"How many date/destination combinations were searched -- what the answer COVERS."

Added value: +{
+  "description": "HTTP requests billed by RapidAPI for this call, retries included; see api_usage.hub_requests_billed.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "Present when something other than the cap ended the fan-out. 'deadline': the call reached its time limit and the remaining combinations were never sent or billed, so the results are real but do not cover the whole range.",
+  "type": "string"
+}

Previous value: -"Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry. 'trial_exhausted': the free signed-in allowance on this server is spent for today, so nothing was searched and nothing was billed; it renews at 00:00 UTC and connecting your own RapidAPI key removes the cap. Retrying does not help."New value: +"Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry. 'trial_exhausted': the free signed-in allowance on this server is spent for today, so nothing was searched and nothing was billed; it renews at 00:00 UTC and connecting your own RapidAPI key removes the cap. Retrying does not help. 'quota_exceeded': the search was refused because the caller's remaining allowance or plan quota cannot cover the number of combinations asked for; combos_requested and combos_allowed_now carry the two numbers. Nothing was searched beyond what it cost to read the quota. Retrying the same search does not help -- ask for fewer dates or nights, or move to a larger plan."

Previous value: -[
-  "ok",
-  "empty",
-  "partial",
-  "degraded",
-  "trial_exhausted"
-]New value: +[
+  "ok",
+  "empty",
+  "partial",
+  "degraded",
+  "trial_exhausted",
+  "quota_exceeded"
+]

Previous value: -"Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry."New value: +"Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry. 'trial_exhausted': the free signed-in allowance on this server is spent for today, so nothing was searched and nothing was billed; it renews at 00:00 UTC and connecting your own RapidAPI key removes the cap. Retrying does not help."

Previous value: -[
-  "ok",
-  "empty",
-  "partial",
-  "degraded"
-]New value: +[
+  "ok",
+  "empty",
+  "partial",
+  "degraded",
+  "trial_exhausted"
+]

Previous value: -"Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry."New value: +"Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry. 'trial_exhausted': the free signed-in allowance on this server is spent for today, so nothing was searched and nothing was billed; it renews at 00:00 UTC and connecting your own RapidAPI key removes the cap. Retrying does not help."

Previous value: -[
-  "ok",
-  "empty",
-  "partial",
-  "degraded"
-]New value: +[
+  "ok",
+  "empty",
+  "partial",
+  "degraded",
+  "trial_exhausted"
+]

Removed value: -true

Added value: +[
+  {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -[
-  "object",
-  "null"
-]

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -[
-  "number",
-  "null"
-]

Removed value: -true

Added value: +[
+  {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -[
-  "object",
-  "null"
-]

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -[
-  "number",
-  "null"
-]

Added value: +{
+  "additionalProperties": {
+    "additionalProperties": true,
+    "properties": {
+      "cheapest": {
+        "additionalProperties": true,
+        "description": "The lowest-priced of this destination's rows in `results`, or null when it has none.",
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "dates": {
+        "additionalProperties": {
+          "additionalProperties": true,
+          "properties": {
+            "cheapest_price": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "reason": {
+              "enum": [
+                "ok",
+                "no_flights",
+                "search_failed",
+                "not_in_limit",
+                "not_searched"
+              ],
+              "type": "string"
+            },
+            "row_count": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "searched": {
+              "type": "boolean"
+            }
+          },
+          "type": "object"
+        },
+        "description": "Present only on multi-date searches: one entry per departure date requested for this destination, so a date the fan-out cap sampled away is visible rather than absent. `cheapest_price` is null when that date has no row in `results`.",
+        "type": "object"
+      },
+      "reason": {
+        "enum": [
+          "ok",
+          "no_flights",
+          "search_failed",
+          "not_in_limit",
+          "not_searched"
+        ],
+        "type": "string"
+      },
+      "rows": {
+        "items": {
+          "additionalProperties": true,
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "searched": {
+        "description": "Whether at least one search actually ran for this destination. False means the fan-out cap dropped it.",
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "rows",
+      "searched",
+      "reason"
+    ],
+    "type": "object"
+  },
+  "description": "One entry per destination the REQUEST asked for, in request order, present whether or not that destination has any flights in `results`. A destination with an empty `rows` array is a hole in the answer, and `reason` says which kind of hole: 'no_flights' (searched, answered, Google has nothing), 'search_failed' (searched and the search errored, so nothing is known), 'not_in_limit' (searched, found flights, none fitted in `limit`) or 'not_searched' (never searched -- the per-call fan-out cap sampled it away). 'ok' means it has rows.\n\nRead this rather than inferring coverage from `results`: a destination missing from `results` looks identical to one that has no flights, and they are not the same answer. `rows` are the same row objects that are in `results`, in the same order -- nothing here is data the answer does not already contain.",
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": {
+    "additionalProperties": true,
+    "properties": {
+      "cheapest": {
+        "additionalProperties": true,
+        "description": "The lowest-priced of this destination's rows in `results`, or null when it has none.",
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "dates": {
+        "additionalProperties": {
+          "additionalProperties": true,
+          "properties": {
+            "cheapest_price": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "reason": {
+              "enum": [
+                "ok",
+                "no_flights",
+                "search_failed",
+                "not_in_limit",
+                "not_searched"
+              ],
+              "type": "string"
+            },
+            "row_count": {
+              "minimum": 0,
+              "type": "integer"
+            },
+            "searched": {
+              "type": "boolean"
+            }
+          },
+          "type": "object"
+        },
+        "description": "Present only on multi-date searches: one entry per departure date requested for this destination, so a date the fan-out cap sampled away is visible rather than absent. `cheapest_price` is null when that date has no row in `results`.",
+        "type": "object"
+      },
+      "reason": {
+        "enum": [
+          "ok",
+          "no_flights",
+          "search_failed",
+          "not_in_limit",
+          "not_searched"
+        ],
+        "type": "string"
+      },
+      "rows": {
+        "items": {
+          "additionalProperties": true,
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "searched": {
+        "description": "Whether at least one search actually ran for this destination. False means the fan-out cap dropped it.",
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "rows",
+      "searched",
+      "reason"
+    ],
+    "type": "object"
+  },
+  "description": "One entry per destination the REQUEST asked for, in request order, present whether or not that destination has any flights in `results`. A destination with an empty `rows` array is a hole in the answer, and `reason` says which kind of hole: 'no_flights' (searched, answered, Google has nothing), 'search_failed' (searched and the search errored, so nothing is known), 'not_in_limit' (searched, found flights, none fitted in `limit`) or 'not_searched' (never searched -- the per-call fan-out cap sampled it away). 'ok' means it has rows.\n\nRead this rather than inferring coverage from `results`: a destination missing from `results` looks identical to one that has no flights, and they are not the same answer. `rows` are the same row objects that are in `results`, in the same order -- nothing here is data the answer does not already contain.",
+  "type": "object"
+}

Previous value: -"Origin IATA code, e.g. \"TLV\"."New value: +"Origin IATA code, e.g. \"TLV\". One origin per search; a second one is refused rather than searched."

Previous value: -"Destination IATA code, or a list of them to compare."New value: +"Destination airport. One IATA code (\"BCN\"), several separated by commas (\"BCN,LIS,ATH\"), or a list ([\"BCN\",\"LIS\",\"ATH\"]) -- every shape is accepted and the destinations are compared in the same search."

Previous value: -"Origin IATA code, e.g. \"TLV\"."New value: +"Origin IATA code, e.g. \"TLV\". One origin per search; a second one is refused rather than searched."

Previous value: -"Destination IATA code, or a list of them to compare."New value: +"Destination airport. One IATA code (\"BCN\"), several separated by commas (\"BCN,LIS,ATH\"), or a list ([\"BCN\",\"LIS\",\"ATH\"]) -- every shape is accepted and the destinations are compared in the same search."

Added value: +"A completed flight search. Read search_status before reading results: an empty array means 'no flights' only when search_status is 'empty'."

Added value: +{
+  "api_usage": {
+    "additionalProperties": true,
+    "description": "What this call cost the caller's own RapidAPI plan, and what remains on it. Present on every response that reached the upstream, including a degraded one -- a search that failed was still billed.",
+    "properties": {
+      "note": {
+        "description": "The same figures as a sentence, for the model to relay.",
+        "type": "string"
+      },
+      "plan_requests_limit": {
+        "type": "integer"
+      },
+      "plan_requests_remaining": {
+        "type": "integer"
+      },
+      "requests_used_by_this_call": {
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "type": "object"
+  },
+  "message": {
+    "description": "Present when there is something the model must relay to the user rather than silently absorb -- no results, a degraded search, a missing key or a spent quota.",
+    "type": "string"
+  },
+  "needs_api_key": {
+    "description": "True when no usable RapidAPI key arrived with the call, or the upstream rejected the one that did. No search was run and nothing was billed; signup_url and message say how to fix it.",
+    "type": "boolean"
+  },
+  "partial": {
+    "description": "Present when some searches failed but others succeeded. Plain text saying how much of the request the results cover.",
+    "type": "string"
+  },
+  "quota_exhausted": {
+    "description": "True when the caller's RapidAPI plan has no requests left for the current period.",
+    "type": "boolean"
+  },
+  "result_count": {
+    "minimum": 0,
+    "type": "integer"
+  },
+  "results": {
+    "description": "The itineraries or properties found, already sorted and deduplicated. An empty array is only meaningful when search_status is 'empty'.",
+    "items": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "search_coverage": {
+    "additionalProperties": true,
+    "description": "What was actually searched. Present whether or not the request was truncated, so a model can state honestly what its answer rests on.",
+    "properties": {
+      "departure_dates_searched": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "destinations_searched": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "max_searches_per_request": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "note": {
+        "type": "string"
+      },
+      "requested_combinations": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "searched_combinations": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "truncated": {
+        "description": "True when the request expanded past this call's spend ceiling and was sampled. A date absent from departure_dates_searched was never searched, which is not the same as having no flights.",
+        "type": "boolean"
+      }
+    },
+    "type": "object"
+  },
+  "search_status": {
+    "description": "Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry.",
+    "enum": [
+      "ok",
+      "empty",
+      "partial",
+      "degraded"
+    ],
+    "type": "string"
+  },
+  "signup_url": {
+    "description": "Where the caller subscribes or changes plan.",
+    "type": "string"
+  }
+}

Added value: +[
+  "results"
+]

Added value: +"Flight search result"

Added value: +"A completed flight search. Read search_status before reading results: an empty array means 'no flights' only when search_status is 'empty'."

Added value: +{
+  "api_usage": {
+    "additionalProperties": true,
+    "description": "What this call cost the caller's own RapidAPI plan, and what remains on it. Present on every response that reached the upstream, including a degraded one -- a search that failed was still billed.",
+    "properties": {
+      "note": {
+        "description": "The same figures as a sentence, for the model to relay.",
+        "type": "string"
+      },
+      "plan_requests_limit": {
+        "type": "integer"
+      },
+      "plan_requests_remaining": {
+        "type": "integer"
+      },
+      "requests_used_by_this_call": {
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "type": "object"
+  },
+  "message": {
+    "description": "Present when there is something the model must relay to the user rather than silently absorb -- no results, a degraded search, a missing key or a spent quota.",
+    "type": "string"
+  },
+  "needs_api_key": {
+    "description": "True when no usable RapidAPI key arrived with the call, or the upstream rejected the one that did. No search was run and nothing was billed; signup_url and message say how to fix it.",
+    "type": "boolean"
+  },
+  "partial": {
+    "description": "Present when some searches failed but others succeeded. Plain text saying how much of the request the results cover.",
+    "type": "string"
+  },
+  "quota_exhausted": {
+    "description": "True when the caller's RapidAPI plan has no requests left for the current period.",
+    "type": "boolean"
+  },
+  "result_count": {
+    "minimum": 0,
+    "type": "integer"
+  },
+  "results": {
+    "description": "The itineraries or properties found, already sorted and deduplicated. An empty array is only meaningful when search_status is 'empty'.",
+    "items": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "search_coverage": {
+    "additionalProperties": true,
+    "description": "What was actually searched. Present whether or not the request was truncated, so a model can state honestly what its answer rests on.",
+    "properties": {
+      "departure_dates_searched": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "destinations_searched": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "max_searches_per_request": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "note": {
+        "type": "string"
+      },
+      "requested_combinations": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "searched_combinations": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "truncated": {
+        "description": "True when the request expanded past this call's spend ceiling and was sampled. A date absent from departure_dates_searched was never searched, which is not the same as having no flights.",
+        "type": "boolean"
+      }
+    },
+    "type": "object"
+  },
+  "search_status": {
+    "description": "Whether the underlying search actually completed, read from the backend's X-Search-Status header. 'ok': every combination searched returned results. 'empty': the search completed and Google genuinely has no itineraries for it -- a real answer, not a failure. 'partial': some combinations returned results and some failed, so the list is incomplete. 'degraded': every combination failed, so the search did not happen and an empty list means nothing; this case is also flagged with isError: true and is safe to retry.",
+    "enum": [
+      "ok",
+      "empty",
+      "partial",
+      "degraded"
+    ],
+    "type": "string"
+  },
+  "signup_url": {
+    "description": "Where the caller subscribes or changes plan.",
+    "type": "string"
+  }
+}

Added value: +[
+  "results"
+]

Added value: +"Flight search result"

Added value: +"Restrict to these airline codes, e.g. [\"LY\"]."

Added value: +"Latest arrival hour, 0-23."

Added value: +"Earliest arrival hour, 0-23."

Added value: +"ISO currency code, default \"usd\"."

Added value: +"Single departure date, \"YYYY-MM-DD\"."

Added value: +"First date of a departure range."

Added value: +"Last date of a departure range."

Added value: +"Latest departure hour, 0-23."

Added value: +"Earliest departure hour, 0-23."

Added value: +"Exclude these airline codes."

Added value: +"Origin IATA code, e.g. \"TLV\"."

Added value: +"Maximum flights to return, after merging and sorting."

Added value: +"Only return flights at or below this price."

Added value: +"Cap the billed requests this call may make. Lower it to spend less of the plan's quota on a wide search; the range is then sampled evenly rather than cut short."

Added value: +"Maximum stops per flight. 0 means non-stop only."

Added value: +"Passenger counts as [adults, children, infants]."

Added value: +"1 economy, 2 premium economy, 3 business, 4 first."

Added value: +"\"best\", \"price\", or \"duration\". Applied across all results."

Added value: +"Destination IATA code, or a list of them to compare."

Added value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -falseNew value: +null

Added value: +"Leave unset. Switches the search to a second, independent flight data source instead of the usual Google Flights page read. Unset already escalates to that source once, automatically, after a search's retries have failed. true forces it inline on every attempt -- much slower, and it can time out. false disables it entirely, that automatic retry included."

Removed value: -"boolean"

Added value: +"ISO currency code, default \"usd\"."

Added value: +"Restrict the outbound leg to these airlines."

Added value: +"Single outbound date, \"YYYY-MM-DD\"."

Added value: +"First date of an outbound range."

Added value: +"Last date of an outbound range."

Added value: +"Origin IATA code, e.g. \"TLV\"."

Added value: +"Maximum trips to return, after merging and sorting."

Added value: +"Maximum stops on the outbound leg."

Added value: +"Only return trips at or below this total price."

Added value: +"Maximum stops on the return leg."

Added value: +"Cap the billed requests this call may make. Lower it to spend less of the plan's quota on a wide search; the range is then sampled evenly rather than cut short."

Added value: +"Trip length in nights; a number, or a list like [5, 6, 7]. The return date is derived from each departure date."

Added value: +"Passenger counts as [adults, children, infants]."

Added value: +"Restrict the return leg to these airlines."

Added value: +"Fixed return date. Use this OR nights, not both."

Added value: +"1 economy, 2 premium economy, 3 business, 4 first."

Added value: +"\"best\", \"price\", or \"duration\". Applied across all results."

Added value: +"Destination IATA code, or a list of them to compare."

Added value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -falseNew value: +null

Added value: +"Leave unset. Switches the search to a second, independent flight data source instead of the usual Google Flights page read. Unset already escalates to that source once, automatically, after a search's retries have failed. true forces it inline on every attempt -- much slower, and it can time out. false disables it entirely, that automatic retry included."

Removed value: -"boolean"