Google Hotels Scraper

Google Hotels 的 Python API

将 Google Hotels 的酒店价格导入 Python，适用于任何城市和日期：每晚价格、含税费的整个住宿总价、Google 的优惠提示（“比平时便宜 23%”）、住客评分、评论数、星级、设施和坐标。Google Hotels 会比价预订网站和酒店官网，因此一次搜索就能了解当前行情。

Google 没有用于读取酒店价格的公共 API。其酒店 API 面向将价格提交给 Google 的旅游合作伙伴。这些示例改用托管式爬虫：Google Hotels Scraper，通过官方 Python 客户端调用。

示例输出：Google 为 2026 年 11 月 13 日至 15 日的周末、2 位成人在 8 个城市展示的前 20 家酒店的每晚价格中位数。使用 examples/compare_cities.py 生成。

快速开始

1. 创建免费的 Apify 账户。免费套餐每月包含 5 美元额度，可查询 1,000 多个酒店价格。无需信用卡。
2. 在 Apify Console 的 Settings > API & Integrations 中复制 API 令牌。
3. 运行一个示例：

pip install -r requirements.txt
export APIFY_TOKEN=your-token        # Windows: set APIFY_TOKEN=your-token
python examples/search_hotels.py

hotel                                      stars rating  a night, all-in
The Central House Lisbon Baixa                 2    4.3           53 EUR
Lisbon Wine House - Rooms & Suites             3    3.7           68 EUR
Next Level Premium Hotels Lisbon               3    4.7           76 EUR
Novotel Lisboa                                 4      4           83 EUR
...
Saved 20 hotels to hotels.csv

示例

文件	功能
examples/search_hotels.py	查询一个城市在指定日期范围内的酒店，按价格从低到高排序，并保存为 CSV
examples/compare_cities.py	比较多个城市在相同日期的价格，并生成上方的图表
examples/cheapest_weekend.py	查询接下来 8 个周末的价格，找出最便宜的周末
examples/price_tracker.py	每日运行：保留价格历史，并列出价格至少下降 10% 的酒店

sample-output/hotels-lisbon-2026-11-13.csv 展示了 search_hotels.py 生成的 CSV。

找出最便宜的周末

在 2026 年 10 月 10 日运行的 cheapest_weekend.py，查询阿姆斯特丹：

Fri 16 Oct to Sun 18 Oct: median EUR 191, cheapest EUR 97 a night
Fri 23 Oct to Sun 25 Oct: median EUR 302, cheapest EUR 28 a night
Fri 30 Oct to Sun 01 Nov: median EUR 140, cheapest EUR 88 a night
Fri 06 Nov to Sun 08 Nov: median EUR 177, cheapest EUR 104 a night
Fri 13 Nov to Sun 15 Nov: median EUR 135, cheapest EUR 96 a night
Fri 20 Nov to Sun 22 Nov: median EUR 133, cheapest EUR 89 a night
Fri 27 Nov to Sun 29 Nov: median EUR 141, cheapest EUR 86 a night
Fri 04 Dec to Sun 06 Dec: median EUR 132, cheapest EUR 78 a night

Cheapest weekend: 04 December (median EUR 132 a night, taxes included)

10 月 23 日所在周末的价格是最便宜周末的两倍多。这是因为阿姆斯特丹舞蹈节（Amsterdam Dance Event）将于 10 月 21 日至 25 日举行。

每家酒店可获取的信息

• Google 展示的 pricePerNight，以及含税费的整个住宿总价 totalPrice；如果 Google 展示了明细，还会提供 totalPriceBeforeTaxes 和 taxesAndFees
• dealText，例如“比平时便宜 23%”
• rating、reviewCount、hotelClass（星级）和 propertyType（酒店、旅舍、度假出租房等）
• amenities、description、checkInTime 和 checkOutTime
• latitude、longitude、website、googleHotelsUrl 和 googleMapsUrl
• hotelId，即 Google 为该酒店分配的 ID，可用于跨次运行匹配酒店

注意事项

• **税费：**Google 面向美国访客展示的每晚价格不含税，而在大多数其他市场展示的价格含税。要比较价格，请像示例中那样使用 totalPrice / nights。
• **每次搜索约 20 家酒店：**这是 Google 的首页结果。要查询某个城市的更多酒店，可添加诸如 hotels in Amsterdam Jordaan 或 hotels near Amsterdam Centraal 的搜索。
• **相对日期：**使用 30 days 和 32 days 可确保计划任务运行时日期仍在未来。若要长期追踪同一次住宿的价格，请改用固定日期。
• 市场：country 输入项（Google 的 gl 设置）决定 Google 会比较哪些预订网站，价格也可能因市场而异。
• **工作原理：**爬虫会加载与你在浏览器中看到的相同 Google Hotels 搜索页面，但不会启动浏览器；它会从页面数据中读取酒店列表，并在 Google 拦截请求时使用新的住宅 IP 重试。

其他选项

• SerpApi 提供 Google Hotels 端点，采用月度订阅。
• 预订网站自有 API 通常仅面向合作伙伴和联盟营销方，且只涵盖其自身价格。

在 AI 助手中使用（MCP）

如需让 Claude、Cursor、VS Code 或其他 MCP 客户端为你查询酒店价格，请添加此 MCP 服务 URL：https://mcp.apify.com/?tools=ralfij/google-hotels-scraper。客户端提示时，请登录 Apify，或发送你的 Apify API 令牌作为 Authorization: Bearer <token>。运行费用计入你自己的 Apify 账户。

备注

• 这些示例中使用的 Google Hotels Scraper 是我开发的，请留意这一点。
• 按酒店计费，无需订阅；请参阅 actor 页面。
• 它仅返回商业数据。访客评论和评论者姓名会有意省略。
• 与 Google 无关联，也未获其认可或赞助。Google Hotels 是 Google LLC 的商标。

许可证

MIT