search_stays
Search Tell & Go stays
Search Tell & Go's live inventory of hotels & resorts in the Maldives, Seychelles, Mauritius, Sri Lanka, Egypt and Paris, plus selected hotels in Bali and the UAE. No account or API key required. Pass dates + adults for live pricing; omitting dates returns catalogue-only results. budget_min/budget_max filter by per-night USD (enforced server-side). If the traveller gives a budget for the whole stay, divide it by the number of nights first. Results are ranked like tellandgo.com: best match first, with live-priced stays inside the budget ahead of the rest. Results are paged: when pagination.has_more is true, more matches exist — call search_stays again with the same parameters and offset=pagination.next_offset before telling the traveller you have shown every option or every stay within budget. If properties comes back empty, read results_note before concluding anything: it distinguishes 'nothing fits the filters' from 'no inventory' and may include cheapest_available — the lowest live rate outside the budget (scoped to the rate-shopped window, see coverage). pricing_status='partial' means live pricing timed out: shown results are catalogue matches, use get_quote for firm prices. The response's status field states the outcome (results / partial_results / no_match / filtered_empty / needs_input / supplier_degraded); coverage says how many candidates were actually priced; effective_request lists the parameters that governed the search with their provenance — disclose any effective_request.assumptions (e.g. defaulted adults or residency) to the user. residency is OPTIONAL here: omit it and the search assumes 'GB' (disclosed in effective_request.assumptions); it becomes REQUIRED at get_quote, so confirm the traveller's residency before quoting. A refine block is an optional question. If the traveller asked you to choose or to go ahead, do not stop to ask it: apply refine.default_answer, tell the traveller in one line what you assumed, and continue to get_quote and start_b
limitquery必填adultsoffsetcheck_inamenitiescheck_outresidencybudget_maxbudget_minjourney_iddestination另有 1 個