Booking Live API - multiple hotels at once
收藏Booking Live API - multiple hotels at once
API 概述
该API用于同时查询多个酒店的可用性和价格,数据来源为Booking.com。每个酒店通过名称查询,返回可用状态、价格和评论信息。
主要功能
Bulk Hotels Availability API (POST /hotels)
请求参数
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
hotel_names |
字符串数组 | 要查询的酒店名称列表,例如 ["Kremlin Palace", "Four Seasons Limassol"] |
checkin_date |
字符串(YYYY-MM-dd) | 入住日期 |
checkout_date |
字符串(YYYY-MM-dd) | 退房日期 |
可选参数
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
area |
字符串 | 无 | 城市/地区名称,用于消除同名酒店的歧义,例如 "Budapest"、"Antalya" |
adults |
整数 | 2 | 成人数量 |
children |
整数 | 0 | 儿童数量 |
currency |
字符串 | "USD" | 货币类型 |
proxy_country |
字符串 | "us" | 两个字母的国家代码,通过该国的住宅代理路由请求,可影响Booking.com上的价格和可用性 |
free_cancellation |
布尔值 | false | 若为true,仅显示可免费取消的房源 |
约束条件
- 每次请求最多查询 5个酒店
响应示例
成功查询到的酒店
json { "Kremlin Palace": { "name": "Kremlin Palace", "available": true, "price_string": "US$2,434", "price": 2434, "review_score": 8.4, "review_count": 701, "room_type": "Superior Double or Twin Room", "image_url": "https://cf.bstatic.com/xdata/images/hotel/square240/501059778.webp?k=...", "link": "https://www.booking.com/hotel/tr/kremlin-palace.html?...", "nights": 9, "adults": 2, "children": 0 } }
未找到或不可用的酒店
json { "Nonexistent Hotel": { "name": "Nonexistent Hotel", "available": false, "price_string": null, "price": null, "review_score": null, "review_count": null, "room_type": null, "image_url": null, "link": null, "nights": null, "adults": null, "children": null } }
查询失败的酒店
json { "Some Hotel": { "error": "Failed to fetch hotel data: ..." } }
数据质量指标
- 流行度:9.3
- 服务级别:100%
- 延迟:13569ms
- 测试通过率:100%
提供方信息
- API 创建者:Matan Rabi
- 订阅者数:10
- 分类:Travel



