Google Hotels

Google Hotels API for real-time hotel search, prices, rates, deals, and property details. Get structured hotel data, availability, pricing, ratings, amenities, and booking information for travel apps, websites, and hotel price comparison.

原始信息汇总

Google Hotels API 数据集详情

基本信息

• API名称: Google Hotels
• 提供方: Crawlio
• 类别: Travel（旅游）
• 订阅用户数: 1
• 定价方案: BASIC（$0.00/月）、PRO（$9.00/月）、ULTRA（$29.00/月）

数据集简介

Google Hotels API 提供实时酒店搜索、价格、房价、优惠和物业详情信息。可获取结构化酒店数据，包括可用性、定价、评分、设施和预订信息，适用于旅游应用、网站和酒店价格比较等场景。该 API 支持全球任意目的地，可按照入住日期、客人数量、房间配置、货币、物业链接、设施、附近交通/机场和真实客人反馈等条件获取数据。

核心功能

• 全球酒店搜索：支持任意城市、地区或地标搜索，可指定入住/退房日期、客人数量、房间数量和货币偏好
• 丰富物业信息：获取星级分类、评分、地址、电话、官网、坐标和照片库等完整酒店详情
• 位置智能与周边信息：提取精确地理坐标、街区层级以及分类的周边兴趣点（机场、地铁站、交通枢纽、餐厅、景点），并附带步行/驾车通勤时间
• 多平台价格比较：比较官方酒店网站、Booking.com、Agoda、Expedia、Trip.com 等主要预订渠道的实时房价、每晚价格、总价、取消政策和直接预订链接
• 深度客人评论：获取评分分布（1-5星）、情感主题、评论来源分布和多来源完整评论流
• 智能分页：通过limit和offset参数配合服务端游标缓存，可遍历多达15,000条酒店结果
• 高吞吐量与低延迟：采用多层缓存架构，响应速度快且错误率低

可用端点

端点	方法	描述
/api/v1/hotels	GET	按位置和入住日期搜索 Google Hotels，支持分页
/api/v1/hotels/details	GET	获取完整酒店物业详情、联系信息、设施和照片
/api/v1/hotels/about	GET	获取简介部分、入住/退房时间和设施分类
/api/v1/hotels/location	GET	获取位置概览以及附近机场、交通和兴趣点
/api/v1/hotels/prices	GET	比较合作伙伴预订价格、房型、优惠和价格
/api/v1/hotels/reviews	GET	获取评分分布、评论来源、情感主题和示例评论
/api/v1/hotels/reviews/complete	GET	通过自动深度分页获取完整评论集合

主要参数说明

搜索酒店（Search Hotels）

参数	类型	必填	描述
location	string	是	城市、地区或目的地查询（如new york、tokyo）
check_in	string	是	入住日期，格式为YYYY-MM-DD
check_out	string	是	退房日期，格式为YYYY-MM-DD
adults	integer	否	成人数量（1-20，默认2）
children	integer	否	儿童数量（0-20，默认0）
rooms	integer	否	请求房间数（1-20，默认1）
currency	string	否	3位ISO货币代码（默认USD）
limit	integer	否	每页返回最大酒店数（1-100，默认20）
offset	integer	否	分页偏移量（0-15000，默认0）

物业相关端点（Details、About、Location、Prices、Reviews等）

参数	类型	必填	描述
url	string	是	Google Hotels 实体 URL
limit	integer	否	价格或评论返回数量限制（价格：0-5000，默认20；评论：0-5000，默认250）

分页机制

• 使用标准的 limit/offset 顺序分页，由内部游标缓存支持
• 分页流程：首次请求使用offset=0，从响应中读取pagination.next_offset，下次请求传入该值获取后续页面
• 最大偏移量可达 15,000

日期格式标准

所有日期参数（check_in、check_out）必须使用 ISO-8601 YYYY-MM-DD 日期格式。

支持的 URL 格式

接受所有标准 Google Hotels 实体和子标签 URL，示例：

• https://www.google.com/travel/hotels/entity/ChkIkPCX3P7fgYq2ARoML2cvMTF5OXpjcWdzEAE
• https://www.google.com/travel/hotels/entity/ChkIkPCX3P7fgYq2ARoML2cvMTF5OXpjcWdzEAE/details
• https://www.google.com/travel/hotels/entity/ChkIkPCX3P7fgYq2ARoML2cvMTF5OXpjcWdzEAE/prices
• https://www.google.com/travel/hotels/entity/ChkIkPCX3P7fgYq2ARoML2cvMTF5OXpjcWdzEAE/reviews
• https://www.google.com/travel/hotels/entity/ChkIkPCX3P7fgYq2ARoML2cvMTF5OXpjcWdzEAE/location

应用场景

适用于旅游平台、价格聚合器、OTA（在线旅行社）、预订引擎和市场调研团队，需要快速、可靠的 Google Hotels 数据情报的业务场景。