怎么调用 Booking 关键词搜索 API?
search使用 platform="booking"、action="search" 调用“关键词搜索”能力;返回列表,默认 10 条、单次最多 30 条,主要包含 id、name、type、url、text、stars 等 26 个字段。
Booking search 的参数分别是什么意思?
keyword必填- Booking 住宿目的地,例如 Amsterdam;search 查酒店、公寓等住宿列表,不是航班、景点或点评正文关键词搜索。
check_in可选- 入住日期,YYYY-MM-DD。search / profile 仅在同时提供 check_in 和 check_out 时传入日期;prices 中作为 start_date 未提供时的起始日期,不创建订单。
check_out可选- 退房日期,YYYY-MM-DD,应与 check_in 一起提供且晚于入住日期。只填这一项不会让 search / profile 带上完整入住区间。
currency可选- 住宿价格展示币种,默认 USD。search / profile 接受本接口列出的币种代码;prices 建议使用大写三字母代码。它不改变 EveryInfra 的 API 计费币种。
查看全部 50 个允许值
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar lang可选- 住宿页面信息语言,默认英式英语;engb / enus 为英式 / 美式英语,zhcn / zhtw 为简体 / 繁体中文。不要直接套用 en 或 zh;此参数不负责翻译 reviews 的点评正文。
查看全部 43 个允许值
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw min_price可选- 当前参数实际接收每晚价格范围字符串,不是单个最低价数字:例如 100-150 表示区间,100+ 表示至少 100。币种由 currency 决定,不能把整个入住期总价填入。
property_type可选- search 的住宿类型文本,保留大小写和空格,例如 Hotels、Apartments、Hostels、Guest houses、Homestays、Bed and breakfasts、Holiday homes、Boats、Villas、Motels、Resorts、Holiday parks、Campsites、Luxury tents;none 表示不限定。不是酒店内的房型名称。
sort可选- 住宿结果排序:distance 为相对搜索地点的距离,popular 为点评综合排序;top_rated 当前映射住宿星级排序,不是最高住客评分。search 默认 popular,对单个住宿的 profile 不应期待产生列表排序效果。
查看全部 3 个允许值
distancepopulartop_rated star_rating可选- 住宿星级筛选:1_star 至 5_stars 为指定星级,unrated 为未评级,any 为不限。住宿星级与住客评论分数不是同一量纲。
Booking 将住宿星级、住客点评分数和质量评级分开介绍;1–5 颗星不是 1–10 分的住客点评,也不应与黄色方块的质量评级混为一谈。官方来源:Booking:住宿星级、点评分数与质量评级来源核查:
查看全部 7 个允许值
1_star2_stars3_stars4_stars5_starsanyunrated
Booking 特有返回字段与含义(8)
- hotel_chain
- 所属连锁品牌,独立酒店为 null。
- stars
- 酒店星级(1–5),是官方评定的硬件等级,与住客评分 rating 不是一回事。
- rating_label
- 评分的文字档位(如 Wonderful / Very good),由 score 分段而来。
- check_in_date
- 本次查询的入住日期。
- check_out_date
- 本次查询的退房日期。
- breakfast
- 早餐说明(含/不含/需加购)。
- latitude
- 纬度。
- longitude
- 经度。