Google Hotels API

RapidAPI2026-09-21 更新2026-09-22 收录

酒店价格比较

旅游元搜索

数据链接：

https://rapidapi.com/nikitaiakovleve33/api/google-hotels-api2 数据链接链接失效反馈

官方服务：

资源简介：

Google Hotels API and hotel rates API for hotel price comparison: every hotel for a city and dates with nightly price, total, taxes, rating, reviews, star class, amenities, coordinates, photos, booking link and per-site prices. 25 rows per request.

创建时间：

2026-09-21

原始信息汇总

Google Hotels API 数据集总结

一、基本信息

数据集地址：https://rapidapi.com/nikitaiakovleve33/api/google-hotels-api2
API 创建者：Nikita Iakovlev
类别：Travel（旅行）
当前版本：1.0.0
订阅者数量：1

二、功能概述

Google Hotels API 可针对指定城市和日期范围，抓取 Google Hotels 上的酒店信息。每次调用返回最多 25 行扁平化 JSON 数据，字段结构固定。无需登录、Cookie 或浏览器。

返回的数据涵盖：每晚价格、总价、税前价格、税费、评分、评论数、星级、设施、坐标、照片及预订链接，并可按需返回各预订网站的具体报价与住客评论。

三、核心数据字段

字段	示例
`type`	"hotel"
`name`	"Pita Maha Resort & Spa"
`hotelClass`	5
`hotelClassLabel`	"5-star hotel"
`propertyType`	"resort hotel"
`rating`	4.8
`reviewCount`	1219
`pricePerNight`	137.87
`pricePerNightDisplay`	"$138"
`totalPrice`	276
`totalPriceDisplay`	"$276"
`priceBeforeTaxes`	275.73
`taxesAndFees`	57.89
`currency`	"USD"
`checkIn`	"2026-10-17"
`checkOut`	"2026-10-19"
`nights`	2
`adults`	2
`country`	"ID"
`latitude`	-8.4956394
`longitude`	115.25377639999999
`amenities`	设施列表
`ratingHistogram`	评分分布
`reviewTopics`	评论主题
`nearbyPlaces`	周边地点
`entityId`	Google 实体 ID
`placeId`	Google 地点 ID
`hotelUrl`	酒店页面链接
`bookingUrl`	预订链接
`searchRank`	搜索排名
`scrapedAt`	抓取时间

每行共包含 42 个字段。

四、接口端点

方法	路径	功能
POST	`/v1/google-hotels-scraper/run`	运行任务并等待（最长 50 秒），结果在 `items` 中返回
POST	`/v1/google-hotels-scraper/runs`	立即启动任务，返回 `runId`
GET	`/v1/google-hotels-scraper/runs/{runId}`	查询状态，任务完成后返回数据行

五、主要输入参数

字段	类型	默认值	说明
`locations`	array	`["Ubud, Bali"]`	地点，可为城市、街区、地区或地标
`checkIn`	string	—	格式 YYYY-MM-DD，留空则搜索距今 30 天后的住宿
`checkOut`	string	—	格式 YYYY-MM-DD，留空则为两晚住宿
`adults`	integer	2	单间成人数量，1–8
`maxHotelsPerLocation`	integer	40	每地点最大酒店数
`currency`	string	"USD"	三位货币代码
`sortBy`	string	"relevance"	排序方式
`hotelClass`	array	—	筛选酒店星级
`minRating`	string	—	最低评分筛选
`maxPricePerNight`	integer	—	每晚最高价格筛选
`poolOnly`	boolean	false	仅返回带泳池的酒店
`includeOffers`	boolean	false	返回各预订网站报价与深度链接
`maxOfferLookups`	integer	20	上述报价查询上限
`includeReviews`	boolean	false	返回评论（文本、评分、日期、来源）
`maxReviews`	integer	10	评论数量上限（通常 10–20）
`hotelUrls`	array	—	Google Hotels 页面 URL 或实体 ID
`language`	string	"en"	两位语言代码
`market`	string	"us"	两位国家代码
`proxyConfiguration`	object	{}	代理配置
`maxRequestRetries`	integer	3	最大重试次数

六、请求示例

curl -X POST https://google-hotels-api2.p.rapidapi.com/v1/google-hotels-scraper/run -H X-RapidAPI-Key: YOUR_KEY -H X-RapidAPI-Host: google-hotels-api2.p.rapidapi.com -H Content-Type: application/json -d {"locations": ["Barcelona"], "checkIn": "2026-11-10", "checkOut": "2026-11-14", "adults": 2, "currency": "EUR", "maxHotelsPerLocation": 25, "includeOffers": true}

七、定价与限制

套餐	价格/月	请求数/月	超额费用	速率限制
BASIC	$0	100	硬性上限	60 请求/小时
PRO	$8	5,000	$0.004/请求	600 请求/小时
ULTRA	$45	40,000	$0.002/请求	5 请求/秒
MEGA	$99	150,000	$0.001/请求	20 请求/秒

计价规则：失败或返回错误行的请求不计费，凭响应的 runId 联系客服即可从用量中扣除。

八、性能指标

热度：9
服务等级：100%
延迟：1609ms
测试：100%
单次请求返回：最多 25 行
冷启动首次调用示例耗时约 27.1 秒

九、批量导出

传入多个 locations，并将 maxHotelsPerLocation 提高至最多 40
超过 50 秒的任务使用「启动任务 + 获取结果」组合
相同请求走缓存，重试不额外消耗运行
ULTRA 套餐下每月可达 1,000,000 行

十、无代码使用方式

n8n / Make / Zapier：使用 HTTP Request 节点，POST https://google-hotels-api2.p.rapidapi.com/v1/google-hotels-scraper/run，携带 X-RapidAPI-Key 与 X-RapidAPI-Host: google-hotels-api2.p.rapidapi.com 头部及 JSON 请求体
Google Sheets：通过 Apps Script 发起相同调用
AI 代理：通过页面上的 MCP Playground 调用同一端点