TOOL API

tuniuHotelSearch

搜索酒店列表。 第一页:传入 cityName(必填)及可选条件(checkIn、checkOut、keyword、poiName、prices 等)查询酒店。响应中会返回 queryId、totalPageNum、currentPageNum,请将 queryId 和 totalPageNum 记录下来供翻页使用。 第二页及以后:传入上次返回的 queryId 和 pageNum(2=第二页,3=第三页,以此类推),不再传城市等搜索条件。例如:{ "queryId": "xxx", "pageNum": 2 }。每次响应都会返回 queryId、totalPageNum、currentPageNum(第二页起接口不返回总页数,由服务端缓存补全)。 使用场景: - 用户想要查找某个城市的酒店(第一页) - 用户想要看更多结果、翻页(使用 queryId + pageNum) - 用户想要按照价格、关键词等筛选酒店 当用户说「还有吗」「翻页」「第二页」「下一页」时,必须用上一轮搜索返回的 queryId 和 pageNum(如 2、3)再次调用本工具,不要只传城市名。 返回信息包括:酒店名称、星级、地址、最低价格等;第一页还会返回 queryId、totalPageNum。

lifestyleOAuth1 credits

Call information

Tool slug
tuniu.tuniuHotelSearch
Provider
Tuniu
Average response
46627 ms
Calls in 7 days
1

Input parameters

queryId

string

pageNum

number

cityName

string

checkIn

string

checkOut

string

adultNum

number

childNum

number

childAges

array

keyword

string

poiName

string

prices

string