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,每个入住日期读取一行。
- 向 /v1/google-hotels/hotel-prices 发送 {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 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 积分,与返回多少个日期无关,拉一整张日历比逐天报价划算。
相关 API
除了 Hotel Price Tracker API,需要其他类型的 Google Hotels 公开数据时,可以使用以下 API。
- Google Hotels API — 按目的地搜索 Google Hotels,返回每家酒店在所选日期的每晚价格、星级、住客评分、评论数、坐标和酒店 ID。
- Google Hotel Details API — 按酒店 ID 获取单个酒店在 Google Hotels 上的完整资料,包括联系方式、设施、周边评分、评分分布、评论主题和各预订网站报价。