Booking.com Hotel Search (Live Prices)

before
{"additionalProperties":true,"description":"A completed hotel search. A single stay carries no search_status: the hotels upstream reports no search-status header, and one call either answered or raised. A DATE-RANGE search does carry one, derived from the fan-out rather than from the upstream -- some of its stays can fail while others answer, and `results` then holds only the cheapest stay's properties, so `stays` is where the shape of the answer lives.","properties":{"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":{"hub_requests_billed":{"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"},"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":{"description":"How many date/destination combinations were searched -- what the answer COVERS.","minimum":0,"type":"integer"}},"type":"object"},"applied_filters":{"description":"Which of the requested filters the upstream actually applied. Untyped: the shape is the upstream's, echoed through."},"caveats":{"description":"Sentences that must be read before one source is called cheaper than another -- differing rating scales, differing tax treatment, differing currencies, a source that did not answer.","items":{"type":"string"},"type":"array"},"cheapest_overall":{"anyOf":[{"additionalProperties":true,"properties":{"checkin_date":{"type":"string"},"checkout_date":{"type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"nights":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price_per_night":{"anyOf":[{"type":"number"},{"type":"null"}]},"property":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"The cheapest priced property for this stay, or null when it has none. The same row the upstream returned, minus its image URL: on a measured search 73% of the payload was URLs, and an image CDN link is the half no model can open. The booking link is kept."},"total":{"type":"number"}},"type":"object"},{"type":"null"}],"description":"The cheapest stay across everything priced, or null when nothing was. `results` holds this stay's full property list."},"message":{"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 stays failed but others were priced. Plain text saying how much of the request the answer covers.","type":"string"},"providers":{"description":"One entry per source that was called, in the order they were requested. Only present when `providers` named more than the default source.","items":{"additionalProperties":true,"description":"What one accommodation source answered. Present for every source that was CALLED, whether or not it answered: a source with search_status 'degraded' carries a reason, a null count and no prices, which is not the same answer as a source that found nothing.","properties":{"cheapest_link":{"anyOf":[{"type":"string"},{"type":"null"}]},"cheapest_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"cheapest_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"How many properties from this source carried a price. Null when the source did not answer -- zero would read as 'nothing there', which a failed search does not know."},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The currency THIS row's totals are in. Rows in different currencies are not comparable and nothing is converted."},"detail":{"description":"Plain text for the model to relay to a human.","type":"string"},"median_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"provider":{"description":"Which source this row is about, e.g. 'booking'.","type":"string"},"rating_scale":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"What a review score from this source is out of: 10 on Booking, 5 on Airbnb. Read it before comparing two scores."},"retrieved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"When these rows were read, taken from the rows themselves rather than from when this answer was assembled."},"search_reason":{"type":"string"},"search_status":{"description":"'ok': the source answered with priced results. 'empty': it answered and had nothing for that stay -- a real answer. 'degraded': it was asked and could not answer, so count is null and an empty list from it means nothing.","enum":["ok","empty","degraded","skipped"],"type":"string"},"taxes_included":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether this source's totals include tax. Null means it has not been established for that source, not that tax is excluded."},"top":{"description":"The cheapest few priced rows from this source.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"required":["provider","search_status"],"type":"object"},"type":"array"},"providers_skipped":{"description":"Sources that were NOT called, each named with why and where to subscribe. A source here contributed nothing to results and is counted nowhere. It is listed rather than dropped because a silently missing source is indistinguishable from a source that had nothing.","items":{"additionalProperties":true,"properties":{"detail":{"type":"string"},"provider":{"type":"string"},"reason":{"description":"'no_key': no RapidAPI key for that source's listing arrived with the call. 'not_subscribed': the key supplied is not subscribed to that listing. 'key_rejected': the key was refused outright.","type":"string"},"subscribe_url":{"type":"string"}},"required":["provider","reason"],"type":"object"},"type":"array"},"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 properties found, already sorted and deduplicated. An empty array is only meaningful when search_status is 'empty'. Each row is the source's own object, passed through. latitude and longitude are the property's WGS84 coordinates in decimal degrees, from the source that answered (Booking.com on Booking rows, Airbnb on Airbnb rows), null when the source publishes none.","items":{"additionalProperties":true,"properties":{"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]}},"type":"object"},"type":"array"},"results_for_stay":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Which stay `results` belongs to on a date-range search, or null when nothing was priced. Without it the rows read as 'the search's results' and get quoted against the wrong dates."},"search_coverage":{"additionalProperties":true,"description":"What was actually priced on a date-range search. Present whether or not the request was truncated, so a model can state honestly what its answer rests on.","properties":{"checkin_dates_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"},"stays_searched":{"description":"The exact date pairs priced.","items":{"additionalProperties":true,"properties":{"checkin_date":{"type":"string"},"checkout_date":{"type":"string"}},"type":"object"},"type":"array"},"stopped_early":{"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"},"truncated":{"description":"True when the request expanded past this call's spend ceiling and was sampled. A stay absent from stays_searched was never priced, which is not the same as having no rooms.","type":"boolean"}},"type":"object"},"search_status":{"description":"Date-range searches only, except 'trial_exhausted'. 'ok': every stay searched was priced. 'empty': they all answered and none had priced availability -- a real answer. 'partial': some stays were priced and some errored. 'degraded': every stay errored, so nothing is known; 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.","enum":["ok","empty","partial","degraded","trial_exhausted","quota_exceeded"],"type":"string"},"signup_url":{"description":"Where the caller subscribes or changes plan.","type":"string"},"stays":{"description":"One entry per stay the REQUEST asked for, in request order, present whether or not that stay was priced. Only on a date-range search (checkin_date_from / checkin_date_to / nights); a single stay does not carry it.\n\nRead this rather than inferring coverage from `results`: `results` holds the full property list for the CHEAPEST stay only, so a stay missing from it looks identical to a stay that had nothing. `reason` says which kind of hole an unpriced stay is: 'no_availability' (searched, answered, nothing came back), 'no_price' (properties came back, none carried a price), 'search_failed' (the search errored, so nothing is known -- not 'no rooms') or 'not_searched' (the per-call fan-out cap sampled it away). Counts are null rather than zero on those last two, because zero reads as 'nothing there' and neither case knows that.","items":{"additionalProperties":true,"properties":{"cheapest":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"The cheapest priced property for this stay, or null when it has none. The same row the upstream returned, minus its image URL: on a measured search 73% of the payload was URLs, and an image CDN link is the half no model can open. The booking link is kept."},"cheapest_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"checkin_date":{"type":"string"},"checkout_date":{"type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"median_total":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Median stay total over this stay's priced properties -- what the date costs generally, next to what its one cheapest room costs."},"nights":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price_per_night":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"cheapest_total divided by nights, rounded."},"priced_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"How many of those carried a price. The others are not evidence about what the stay costs."},"property_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Properties returned for this stay. Null when it was not searched or its search errored."},"reason":{"enum":["ok","no_availability","no_price","search_failed","not_searched"],"type":"string"},"search_status":{"enum":["ok","empty","degraded","not_searched"],"type":"string"}},"required":["checkin_date","checkout_date","search_status","reason"],"type":"object"},"type":"array"}},"required":["results"],"title":"Hotel search result","type":"object"}

after
{"additionalProperties":true,"description":"A completed hotel search. A single stay carries no search_status: the hotels upstream reports no search-status header, and one call either answered or raised. A DATE-RANGE search does carry one, derived from the fan-out rather than from the upstream -- some of its stays can fail while others answer, and `results` then holds only the cheapest stay's properties, so `stays` is where the shape of the answer lives.","properties":{"api_usage":{"additionalProperties":true,"description":"With the caller's own key: what this call cost their RapidAPI plan, and what remains on it. On a free signed-in search (`trial` present): the day's free-search counter instead, and no plan figures -- the search ran on FlightPowers' key and nothing is billed to the user. Present on every response that reached the upstream, including a degraded one.","properties":{"free_searches_day_cap":{"minimum":0,"type":"integer"},"free_searches_remaining_today":{"minimum":0,"type":"integer"},"free_searches_used_today":{"minimum":0,"type":"integer"},"hub_requests_billed":{"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. With the caller's own key this is the figure their RapidAPI plan is charged. Absent on a free search.","minimum":0,"type":"integer"},"note":{"description":"The same figures as one plain sentence.","type":"string"},"plan_requests_limit":{"type":"integer"},"plan_requests_remaining":{"type":"integer"},"requests_used_by_this_call":{"description":"How many date/destination combinations were searched -- what the answer COVERS.","minimum":0,"type":"integer"}},"type":"object"},"applied_filters":{"description":"Which of the requested filters the upstream actually applied. Untyped: the shape is the upstream's, echoed through."},"cheapest_overall":{"anyOf":[{"additionalProperties":true,"properties":{"checkin_date":{"type":"string"},"checkout_date":{"type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"nights":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price_per_night":{"anyOf":[{"type":"number"},{"type":"null"}]},"property":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"The cheapest priced property for this stay, or null when it has none. The same row the upstream returned, minus its image URL: on a measured search 73% of the payload was URLs, so image URLs are dropped to keep the payload small. The booking link is kept."},"total":{"type":"number"}},"type":"object"},{"type":"null"}],"description":"The cheapest stay across everything priced, or null when nothing was. `results` holds this stay's full property list."},"message":{"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 describe the fix.","type":"boolean"},"partial":{"description":"Present when some stays failed but others were priced. Plain text saying how much of the request the answer covers.","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 properties found, in the order Booking.com returned them. An empty array is only meaningful when search_status is 'empty'. By default at most `limit` rows (10), the cheapest always included, each the source's own object without image URLs, with the booking link cut to its stay parameters and price_per_night (the stay total divided by its nights) added; `verbose: true` returns the source's rows untouched. latitude and longitude are the property's WGS84 coordinates in decimal degrees, from Booking.com, null when it publishes none.","items":{"additionalProperties":true,"properties":{"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_per_night":{"anyOf":[{"type":"number"},{"type":"null"}]}},"type":"object"},"type":"array"},"results_for_stay":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Which stay `results` belongs to on a date-range search, or null when nothing was priced. `results` holds this stay's properties only, not the whole range's."},"results_note":{"description":"Present when `limit` left properties out: how many were found and how to see more.","type":"string"},"results_total":{"description":"How many properties the source returned for the stay in `results`, before `limit`. Absent with `verbose: true` and no `limit`, where every row is in `results`.","minimum":0,"type":"integer"},"search_coverage":{"additionalProperties":true,"description":"What was actually priced on a date-range search. Present whether or not the request was truncated, so the answer's basis is on the record either way.","properties":{"checkin_dates_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"},"stays_searched":{"description":"The exact date pairs priced.","items":{"additionalProperties":true,"properties":{"checkin_date":{"type":"string"},"checkout_date":{"type":"string"}},"type":"object"},"type":"array"},"stopped_early":{"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 cover only part of the range.","type":"string"},"truncated":{"description":"True when the request expanded past this call's spend ceiling and was sampled. A stay absent from stays_searched was never priced, which is not the same as having no rooms.","type":"boolean"}},"type":"object"},"search_status":{"description":"Date-range searches only, except 'trial_exhausted'. 'ok': every stay searched was priced. 'empty': they all answered and none had priced availability -- a real answer. 'partial': some stays were priced and some errored. 'degraded': every stay errored, so nothing is known; 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 the caller's own RapidAPI key, once connected, 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; a request with fewer dates or nights, or a larger plan, does.","enum":["ok","empty","partial","degraded","trial_exhausted","quota_exceeded"],"type":"string"},"signup_url":{"description":"Where the caller subscribes or changes plan.","type":"string"},"stays":{"description":"One entry per stay the REQUEST asked for, in request order, present whether or not that stay was priced. Only on a date-range search (checkin_date_from / checkin_date_to / nights); a single stay does not carry it.\n\nCoverage comes from here, not from `results`: `results` holds the full property list for the CHEAPEST stay only, so a stay missing from it looks identical to a stay that had nothing. `reason` says which kind of hole an unpriced stay is: 'no_availability' (searched, answered, nothing came back), 'no_price' (properties came back, none carried a price), 'search_failed' (the search errored, so nothing is known -- not 'no rooms') or 'not_searched' (the per-call fan-out cap sampled it away). Counts are null rather than zero on those last two, because zero reads as 'nothing there' and neither case knows that.","items":{"additionalProperties":true,"properties":{"cheapest":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"The cheapest priced property for this stay, or null when it has none. The same row the upstream returned, minus its image URL: on a measured search 73% of the payload was URLs, so image URLs are dropped to keep the payload small. The booking link is kept."},"cheapest_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"checkin_date":{"type":"string"},"checkout_date":{"type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"median_total":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Median stay total over this stay's priced properties -- what the date costs generally, next to what its one cheapest room costs."},"nights":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price_per_night":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"cheapest_total divided by nights, rounded."},"priced_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"How many of those carried a price. The others are not evidence about what the stay costs."},"property_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Properties returned for this stay. Null when it was not searched or its search errored."},"reason":{"enum":["ok","no_availability","no_price","search_failed","not_searched"],"type":"string"},"search_status":{"enum":["ok","empty","degraded","not_searched"],"type":"string"}},"required":["checkin_date","checkout_date","search_status","reason"],"type":"object"},"type":"array"}},"required":["results"],"title":"Hotel search result","type":"object"}

before
{"additionalProperties":true,"description":"A completed hotel search. A single stay carries no search_status: the hotels upstream reports no search-status header, and one call either answered or raised. A DATE-RANGE search does carry one, derived from the fan-out rather than from the upstream -- some of its stays can fail while others answer, and `results` then holds only the cheapest stay's properties, so `stays` is where the shape of the answer lives.","properties":{"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"},"applied_filters":{"description":"Which of the requested filters the upstream actually applied. Untyped: the shape is the upstream's, echoed through."},"caveats":{"description":"Sentences that must be read before one source is called cheaper than another -- differing rating scales, differing tax treatment, differing currencies, a source that did not answer.","items":{"type":"string"},"type":"array"},"cheapest_overall":{"anyOf":[{"additionalProperties":true,"properties":{"checkin_date":{"type":"string"},"checkout_date":{"type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"nights":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price_per_night":{"anyOf":[{"type":"number"},{"type":"null"}]},"property":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"The cheapest priced property for this stay, or null when it has none. The same row the upstream returned, minus its image URL: on a measured search 73% of the payload was URLs, and an image CDN link is the half no model can open. The booking link is kept."},"total":{"type":"number"}},"type":"object"},{"type":"null"}],"description":"The cheapest stay across everything priced, or null when nothing was. `results` holds this stay's full property list."},"message":{"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 stays failed but others were priced. Plain text saying how much of the request the answer covers.","type":"string"},"providers":{"description":"One entry per source that was called, in the order they were requested. Only present when `providers` named more than the default source.","items":{"additionalProperties":true,"description":"What one accommodation source answered. Present for every source that was CALLED, whether or not it answered: a source with search_status 'degraded' carries a reason, a null count and no prices, which is not the same answer as a source that found nothing.","properties":{"cheapest_link":{"anyOf":[{"type":"string"},{"type":"null"}]},"cheapest_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"cheapest_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"How many properties from this source carried a price. Null when the source did not answer -- zero would read as 'nothing there', which a failed search does not know."},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The currency THIS row's totals are in. Rows in different currencies are not comparable and nothing is converted."},"detail":{"description":"Plain text for the model to relay to a human.","type":"string"},"median_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"provider":{"description":"Which source this row is about, e.g. 'booking'.","type":"string"},"rating_scale":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"What a review score from this source is out of: 10 on Booking, 5 on Airbnb. Read it before comparing two scores."},"retrieved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"When these rows were read, taken from the rows themselves rather than from when this answer was assembled."},"search_reason":{"type":"string"},"search_status":{"description":"'ok': the source answered with priced results. 'empty': it answered and had nothing for that stay -- a real answer. 'degraded': it was asked and could not answer, so count is null and an empty list from it means nothing.","enum":["ok","empty","degraded","skipped"],"type":"string"},"taxes_included":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether this source's totals include tax. Null means it has not been established for that source, not that tax is excluded."},"top":{"description":"The cheapest few priced rows from this source.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"required":["provider","search_status"],"type":"object"},"type":"array"},"providers_skipped":{"description":"Sources that were NOT called, each named with why and where to subscribe. A source here contributed nothing to results and is counted nowhere. It is listed rather than dropped because a silently missing source is indistinguishable from a source that had nothing.","items":{"additionalProperties":true,"properties":{"detail":{"type":"string"},"provider":{"type":"string"},"reason":{"description":"'no_key': no RapidAPI key for that source's listing arrived with the call. 'not_subscribed': the key supplied is not subscribed to that listing. 'key_rejected': the key was refused outright.","type":"string"},"subscribe_url":{"type":"string"}},"required":["provider","reason"],"type":"object"},"type":"array"},"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"},"results_for_stay":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Which stay `results` belongs to on a date-range search, or null when nothing was priced. Without it the rows read as 'the search's results' and get quoted against the wrong dates."},"search_coverage":{"additionalProperties":true,"description":"What was actually priced on a date-range search. Present whether or not the request was truncated, so a model can state honestly what its answer rests on.","properties":{"checkin_dates_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"},"stays_searched":{"description":"The exact date pairs priced.","items":{"additionalProperties":true,"properties":{"checkin_date":{"type":"string"},"checkout_date":{"type":"string"}},"type":"object"},"type":"array"},"truncated":{"description":"True when the request expanded past this call's spend ceiling and was sampled. A stay absent from stays_searched was never priced, which is not the same as having no rooms.","type":"boolean"}},"type":"object"},"search_status":{"description":"Date-range searches only, except 'trial_exhausted'. 'ok': every stay searched was priced. 'empty': they all answered and none had priced availability -- a real answer. 'partial': some stays were priced and some errored. 'degraded': every stay errored, so nothing is known; 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.","enum":["ok","empty","partial","degraded","trial_exhausted"],"type":"string"},"signup_url":{"description":"Where the caller subscribes or changes plan.","type":"string"},"stays":{"description":"One entry per stay the REQUEST asked for, in request order, present whether or not that stay was priced. Only on a date-range search (checkin_date_from / checkin_date_to / nights); a single stay does not carry it.\n\nRead this rather than inferring coverage from `results`: `results` holds the full property list for the CHEAPEST stay only, so a stay missing from it looks identical to a stay that had nothing. `reason` says which kind of hole an unpriced stay is: 'no_availability' (searched, answered, nothing came back), 'no_price' (properties came back, none carried a price), 'search_failed' (the search errored, so nothing is known -- not 'no rooms') or 'not_searched' (the per-call fan-out cap sampled it away). Counts are null rather than zero on those last two, because zero reads as 'nothing there' and neither case knows that.","items":{"additionalProperties":true,"properties":{"cheapest":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"The cheapest priced property for this stay, or null when it has none. The same row the upstream returned, minus its image URL: on a measured search 73% of the payload was URLs, and an image CDN link is the half no model can open. The booking link is kept."},"cheapest_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"checkin_date":{"type":"string"},"checkout_date":{"type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"median_total":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Median stay total over this stay's priced properties -- what the date costs generally, next to what its one cheapest room costs."},"nights":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price_per_night":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"cheapest_total divided by nights, rounded."},"priced_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"How many of those carried a price. The others are not evidence about what the stay costs."},"property_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Properties returned for this stay. Null when it was not searched or its search errored."},"reason":{"enum":["ok","no_availability","no_price","search_failed","not_searched"],"type":"string"},"search_status":{"enum":["ok","empty","degraded","not_searched"],"type":"string"}},"required":["checkin_date","checkout_date","search_status","reason"],"type":"object"},"type":"array"}},"required":["results"],"title":"Hotel search result","type":"object"}

after
{"additionalProperties":true,"description":"A completed hotel search. A single stay carries no search_status: the hotels upstream reports no search-status header, and one call either answered or raised. A DATE-RANGE search does carry one, derived from the fan-out rather than from the upstream -- some of its stays can fail while others answer, and `results` then holds only the cheapest stay's properties, so `stays` is where the shape of the answer lives.","properties":{"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":{"hub_requests_billed":{"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"},"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":{"description":"How many date/destination combinations were searched -- what the answer COVERS.","minimum":0,"type":"integer"}},"type":"object"},"applied_filters":{"description":"Which of the requested filters the upstream actually applied. Untyped: the shape is the upstream's, echoed through."},"caveats":{"description":"Sentences that must be read before one source is called cheaper than another -- differing rating scales, differing tax treatment, differing currencies, a source that did not answer.","items":{"type":"string"},"type":"array"},"cheapest_overall":{"anyOf":[{"additionalProperties":true,"properties":{"checkin_date":{"type":"string"},"checkout_date":{"type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"nights":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price_per_night":{"anyOf":[{"type":"number"},{"type":"null"}]},"property":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"The cheapest priced property for this stay, or null when it has none. The same row the upstream returned, minus its image URL: on a measured search 73% of the payload was URLs, and an image CDN link is the half no model can open. The booking link is kept."},"total":{"type":"number"}},"type":"object"},{"type":"null"}],"description":"The cheapest stay across everything priced, or null when nothing was. `results` holds this stay's full property list."},"message":{"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 stays failed but others were priced. Plain text saying how much of the request the answer covers.","type":"string"},"providers":{"description":"One entry per source that was called, in the order they were requested. Only present when `providers` named more than the default source.","items":{"additionalProperties":true,"description":"What one accommodation source answered. Present for every source that was CALLED, whether or not it answered: a source with search_status 'degraded' carries a reason, a null count and no prices, which is not the same answer as a source that found nothing.","properties":{"cheapest_link":{"anyOf":[{"type":"string"},{"type":"null"}]},"cheapest_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"cheapest_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"How many properties from this source carried a price. Null when the source did not answer -- zero would read as 'nothing there', which a failed search does not know."},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The currency THIS row's totals are in. Rows in different currencies are not comparable and nothing is converted."},"detail":{"description":"Plain text for the model to relay to a human.","type":"string"},"median_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"provider":{"description":"Which source this row is about, e.g. 'booking'.","type":"string"},"rating_scale":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"What a review score from this source is out of: 10 on Booking, 5 on Airbnb. Read it before comparing two scores."},"retrieved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"When these rows were read, taken from the rows themselves rather than from when this answer was assembled."},"search_reason":{"type":"string"},"search_status":{"description":"'ok': the source answered with priced results. 'empty': it answered and had nothing for that stay -- a real answer. 'degraded': it was asked and could not answer, so count is null and an empty list from it means nothing.","enum":["ok","empty","degraded","skipped"],"type":"string"},"taxes_included":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether this source's totals include tax. Null means it has not been established for that source, not that tax is excluded."},"top":{"description":"The cheapest few priced rows from this source.","items":{"additionalProperties":true,"type":"object"},"type":"array"}},"required":["provider","search_status"],"type":"object"},"type":"array"},"providers_skipped":{"description":"Sources that were NOT called, each named with why and where to subscribe. A source here contributed nothing to results and is counted nowhere. It is listed rather than dropped because a silently missing source is indistinguishable from a source that had nothing.","items":{"additionalProperties":true,"properties":{"detail":{"type":"string"},"provider":{"type":"string"},"reason":{"description":"'no_key': no RapidAPI key for that source's listing arrived with the call. 'not_subscribed': the key supplied is not subscribed to that listing. 'key_rejected': the key was refused outright.","type":"string"},"subscribe_url":{"type":"string"}},"required":["provider","reason"],"type":"object"},"type":"array"},"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"},"results_for_stay":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"Which stay `results` belongs to on a date-range search, or null when nothing was priced. Without it the rows read as 'the search's results' and get quoted against the wrong dates."},"search_coverage":{"additionalProperties":true,"description":"What was actually priced on a date-range search. Present whether or not the request was truncated, so a model can state honestly what its answer rests on.","properties":{"checkin_dates_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"},"stays_searched":{"description":"The exact date pairs priced.","items":{"additionalProperties":true,"properties":{"checkin_date":{"type":"string"},"checkout_date":{"type":"string"}},"type":"object"},"type":"array"},"stopped_early":{"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"},"truncated":{"description":"True when the request expanded past this call's spend ceiling and was sampled. A stay absent from stays_searched was never priced, which is not the same as having no rooms.","type":"boolean"}},"type":"object"},"search_status":{"description":"Date-range searches only, except 'trial_exhausted'. 'ok': every stay searched was priced. 'empty': they all answered and none had priced availability -- a real answer. 'partial': some stays were priced and some errored. 'degraded': every stay errored, so nothing is known; 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.","enum":["ok","empty","partial","degraded","trial_exhausted","quota_exceeded"],"type":"string"},"signup_url":{"description":"Where the caller subscribes or changes plan.","type":"string"},"stays":{"description":"One entry per stay the REQUEST asked for, in request order, present whether or not that stay was priced. Only on a date-range search (checkin_date_from / checkin_date_to / nights); a single stay does not carry it.\n\nRead this rather than inferring coverage from `results`: `results` holds the full property list for the CHEAPEST stay only, so a stay missing from it looks identical to a stay that had nothing. `reason` says which kind of hole an unpriced stay is: 'no_availability' (searched, answered, nothing came back), 'no_price' (properties came back, none carried a price), 'search_failed' (the search errored, so nothing is known -- not 'no rooms') or 'not_searched' (the per-call fan-out cap sampled it away). Counts are null rather than zero on those last two, because zero reads as 'nothing there' and neither case knows that.","items":{"additionalProperties":true,"properties":{"cheapest":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"description":"The cheapest priced property for this stay, or null when it has none. The same row the upstream returned, minus its image URL: on a measured search 73% of the payload was URLs, and an image CDN link is the half no model can open. The booking link is kept."},"cheapest_total":{"anyOf":[{"type":"number"},{"type":"null"}]},"checkin_date":{"type":"string"},"checkout_date":{"type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"median_total":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Median stay total over this stay's priced properties -- what the date costs generally, next to what its one cheapest room costs."},"nights":{"anyOf":[{"type":"integer"},{"type":"null"}]},"price_per_night":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"cheapest_total divided by nights, rounded."},"priced_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"How many of those carried a price. The others are not evidence about what the stay costs."},"property_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Properties returned for this stay. Null when it was not searched or its search errored."},"reason":{"enum":["ok","no_availability","no_price","search_failed","not_searched"],"type":"string"},"search_status":{"enum":["ok","empty","degraded","not_searched"],"type":"string"}},"required":["checkin_date","checkout_date","search_status","reason"],"type":"object"},"type":"array"}},"required":["results"],"title":"Hotel search result","type":"object"}