Booking Hotels
收藏官方服务：
资源简介：
Search hotels, get detailed property data, and collect guest reviews from Booking.com.
创建时间：
2026-08-14
原始信息汇总
数据集概述：Booking Hotels API
API 名称：Booking Hotels
提供方：RapidAPI（由 mholdb 发布）
类别：旅行
核心功能：搜索目的地酒店、获取酒店详情、收集住客评价，数据来源于 Booking.com（非官方服务，与 Booking.com 无关联）。
主要功能
- 酒店搜索：按目的地（城市、区域、国家、地标、机场或物业名称）搜索酒店，支持指定入住/退房日期、入住人数、排序方式及多重筛选条件。
- 酒店详情：通过 Booking.com 酒店 ID 或支持 URL 获取规范化公开信息，包括描述、星级、设施、照片、周边环境、评分、房间及住宿价格（可选入住日期以请求价格和空房数据）。
- 住客评价：每酒店最多收集 1,000 条公开评价（受订阅计划限制），返回评分、标题、正文、日期、住客姓名和国家。
- 字段选择：可自定义返回的顶层结果字段（搜索最多 8 个，酒店最多 30 个，评价最多 7 个，支持
["*"]）。 - 状态指示：返回分页和部分结果状态（如
partial、failedSections、truncated）。
使用方式
提供三个路由端点，每次成功调用消耗 1 个 scraper.run 信用点及 1 个 RapidAPI 请求，返回 HTTP 201：
| 路由 | 请求方法 | 用途 |
|---|---|---|
https://scraper.run/api/v1/tools/booking/search |
POST | 搜索酒店列表 |
https://scraper.run/api/v1/tools/booking/hotel |
POST | 获取单个酒店详情 |
https://scraper.run/api/v1/tools/booking/reviews |
POST | 获取酒店评价 |
主要参数说明
搜索（Search）
- 必填：
search（目的地或物业名称）、checkIn、checkOut（格式YYYY-MM-DD，不可为过去日期，且checkOut须晚于checkIn）。 - 可选：
adults（1-30，默认 2）、children（0-10）、childrenAges（每个儿童一个 0-17 的整数）、rooms（1-30）、maxResults（1-250，默认 20）、language（如en-us）、sortBy（relevance、rating_highest、rating_lowest、newest_first、oldest_first）。 - 筛选器：星级（1-5）、价格范围（
min/max/currency）、评分（5+至9+）、物业类型、周边区域、餐饮计划、设施、品牌、免费取消、距中心距离（1km/3km/5km）、可持续性、卧室/床数、旅行目的等。动态筛选数组最多 50 项，支持本地化标签或规范 ID，未知或歧义标签会被忽略。
酒店（Hotel）
- 必填：
hotel（正整数 ID 1 ~ 2,147,483,647，或符合格式的 HTTPS Booking.com URL）。 - 可选：
checkIn/checkOut（须同时提供）、adults、children、childrenAges、rooms、language、fields。 - 返回字段（默认）：
hotelId、name、url、accommodationType、address、city、countryCode、latitude、longitude、starRating、description、summary、reviewScore、reviewsCount、ratingScores、houseRules、meals、restaurants、featuredReviews、legalInfo、pricing、availableRooms、scrapedAt。可通过fields: ["*"]额外请求preferredLevel、isTravelProud、isSustainable、facilities、photos、surroundings、finePrints。
评价（Reviews）
- 必填：
hotel（同酒店 ID/URL 规则）。 - 可选：
maxReviews（1-1000，默认 20，且不超过订阅计划限制）、language、fields（7 个字段：score、title、positiveText、negativeText、date、guestName、guestCountry）。
响应与错误
- 成功响应：所有响应包含
data和meta，meta含tool、creditsUsed、requestId。部分结果会用partial/failedSections（酒店）或truncated（搜索、评价）标记。 - 常见错误码：
400（校验失败）、401（认证缺失/无效）、402（无订阅或信用点）、403（无权访问）、404（目的地/酒店未找到）、409（重复请求 ID）、429（速率限制）、500（内部错误）、502（上游错误）、503（服务不可用）、504（60 秒超时）。
其他说明
- 数据时效性：酒店价格、可用性、评分和评价会变化，取决于日期、人数、货币和来源状态。
- 限制：每个 scraper.run 用户最多 2 个并发 Booking 调用；不支持批量酒店输入、相对日期、无限值（
0）、代理设置、持久化数据集、弹性日期、坐标半径搜索等。 - 请求格式：请求体结构严格，未知字段会导致
400 validation_error。 - 订阅计划：提供免费（BASIC）、PRO（$4.99/月）、ULTRA（$24.99/月）、MEGA（$49.99/月）等档次，评价数量和调用额度受计划限制。
