Google Hotel Details
Google 酒店的详情页既有地址、电话、入住时间和设施清单,也汇总了住客的声音:各星级评价的占比,位置、早餐等话题的正负面提及数,以及从其他点评网站带过来的评分。再对照各预订网站和酒店官网对同一次入住的报价,这些信息足以支撑价格一致性检查、竞争酒店对比和更完整的酒店展示页。
Google Hotel Details API 主要特性
- 每个预订网站的报价offers 列出每个卖家的每晚价格和预订链接,is_official、is_sponsored 和 free_cancellation_until 分别标出官网价、付费推广位和可免费取消的报价。
- 住客在聊什么review_topics 给出 Wellness、Breakfast 等话题的 positive_count、negative_count 和 mentions_count,一眼看出入住体验中哪些环节被称赞、哪些被吐槽。
- 评分分布与外站评分rating_distribution 给出各星级评价的占比,other_reviews 带上 Tripadvisor 等网站的评分、评价数和一段评价摘录。
- 周边位置评分location_scores 从 1 到 5 给出总体、景点活动、餐饮、交通和前往机场的评分,并附街区名称和坐标。
- 酒店基本信息一行到位address、phone、website、check_in_time、check_out_time、可用设施、简介和照片随同一行返回。
- 按你的日期报价check_in、check_out 和 currency 决定报价对应的入住安排;不传日期时按明天入住一晚报价。
Google Hotel Details 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。 |
如何使用 Google Hotel Details API
提交酒店搜索结果里的酒店 ID,以单行结果读取这家酒店。
- 向 /v1/google-hotels/hotel-details 发送 {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 results.items 读取这家酒店;has_more 和 results.next_cursor 遵循通用分页规则,单行结果下为空。
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'Google Hotel Details API 最佳使用场景
- 价格一致性监控: 把标记 is_official 的官网报价与在线旅行社的同日报价对比,找出低于官网价的卖家。
- 竞争酒店对比: 把周边酒店的 rating_distribution、review_topics 和 location_scores 并排比较,看一家酒店领先或落后在哪里。
- 完善酒店展示页: 一次查询拿到地址、设施、入住时间、照片和周边评分,直接填充旅行产品里的酒店页面。
- 住客反馈研究: 按 negative_count 给 review_topics 排序,找出噪音、早餐等最常被住客差评的环节。
Google Hotel Details API 使用建议
- 使用近期 Google Hotels API 搜索得到的酒店 ID,每次 2 积分的请求就能拿到你要的那家酒店。
- 沿用搜索时的 check_in、check_out 和 currency,报价才能和搜索价格对得上。
- 做价格对比前先按 is_sponsored 过滤,避免付费推广位干扰结论。
- 绘制评分分布时,把 rating_distribution.share 当作 0 到 1 的比例来读。
相关 API
除了 Google Hotel Details API,需要其他类型的 Google Hotels 公开数据时,可以使用以下 API。
- Google Hotels API — 按目的地搜索 Google Hotels,返回每家酒店在所选日期的每晚价格、星级、住客评分、评论数、坐标和酒店 ID。
- Hotel Price Tracker API — 按酒店 ID 获取单个酒店在 Google Hotels 上的价格日历,给出未来约 6–8 周内每个入住日期的最低每晚价格。