google-hotels/
hotel-prices

按酒店 ID 拉取一家酒店的 Google 酒店价格日历,每个入住日期给出最低单晚价格,通常覆盖起始日之后的六到八周。

Hotel Price Tracker API

每晚价格日历
每个入住日期一行
指定币种
按酒店 ID 查询
每次请求 4 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Hotel Price Tracker

Google 酒店的价格日历,列出同一家酒店在未来几周里从每一天入住、住一晚的最低价格。把这些单晚价格连成序列,就能看出工作日和周末的价差、旺季高峰和最便宜的预订窗口,用于价格追踪、收益复盘和行程规划。

Hotel Price Tracker API 主要特性

  • 价格日历按行返回每行是一个入住日期,check_out 为次日,price.amount、price.currency 和格式化价格给出这一晚的最低价。
  • 一次请求覆盖数周一次查询通常覆盖六到八周的入住日期,不必逐天单独报价。
  • 自选起始日期check_in 决定日历从哪天开始,需与 check_out 一起提供;不传时从明天开始。
  • 按酒店和日期定位每一行每行都带 hotel_id 和 name,id 由酒店 ID 加入住日期组成,多次运行的结果很容易合并。

Hotel Price Tracker API 参数

参数必填描述
hotel_id必填酒店 ID,取自 Google Hotels API 结果中的 id 字段。
check_in可选日历的起始日期,格式为 YYYY-MM-DD,不能早于今天。需与 check_out 一起提供;两者都不传时从明天开始。
check_out可选离店日期,格式为 YYYY-MM-DD,需晚于 check_in,最长 30 晚。
currency可选每晚价格使用的三位币种代码,例如 USD 或 EUR。
location_code可选搜索市场的位置代码,默认 2840(美国)。
language_code可选结果的语言代码,默认 en。

如何使用 Hotel Price Tracker API

提交酒店 ID,每个入住日期读取一行。

  1. 向 /v1/google-hotels/hotel-prices 发送 {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 results.items 读取各日期的价格;has_more 为 true 时,用 results.next_cursor 请求下一页。
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-prices" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'

Hotel Price Tracker API 最佳使用场景

  • 找出最便宜的日期: 按 price.amount 排序,挑出未来几周里价格最低的入住日期来安排行程。
  • 工作日与周末价差: 按 check_in 对应的星期几分组,算出一家酒店周五、周六晚上比平日贵多少。
  • 追踪价格变动: 定时拉取价格日历,按 id 对比同一晚在不同批次中的价格,看酒店何时涨价或降价。
  • 对比竞争酒店: 用同一币种拉取几家周边酒店的日历,按 check_in 画在一起,逐晚比较谁的价格更有优势。

Hotel Price Tracker API 使用建议

  • 以 id(酒店 ID 加入住日期)作为存储主键,每天重复运行时会更新同一晚的记录,不会产生重复行。
  • 想看更远的日期,就把 check_in 往后挪,再发起一次请求。
  • 比较多家酒店或多次运行的价格时,固定使用同一个 currency。
  • 每次请求固定计 4 积分,与返回多少个日期无关,拉一整张日历比逐天报价划算。

除了 Hotel Price Tracker API,需要其他类型的 Google Hotels 公开数据时,可以使用以下 API。

  • Google Hotels API — 按目的地搜索 Google Hotels,返回每家酒店在所选日期的每晚价格、星级、住客评分、评论数、坐标和酒店 ID。
  • Google Hotel Details API — 按酒店 ID 获取单个酒店在 Google Hotels 上的完整资料,包括联系方式、设施、周边评分、评分分布、评论主题和各预订网站报价。

探索其他平台

还可以将 Google Hotels 数据与其他已支持社交平台的公开数据结合使用。

Hotel Price Tracker API — 常见问题

Hotel Price Tracker API 是一个按酒店 ID 读取 Google 酒店价格日历的 API,返回大约未来六到八周里每个入住日期的最低单晚价格。

每行都是一晚的价格:check_out 是 check_in 的次日,price 是这一晚的最低价。

通常从起始日开始覆盖六到八周;传了 check_in 就从那天开始,否则从明天开始。

把 currency 设为 USD、EUR 等三位代码即可,每行都会注明报价所用的币种。

每次请求计 4 积分,返回一家酒店的完整日历。