google-hotels/
hotel-details

按酒店 ID 读取一家酒店在 Google 酒店上的完整资料:联系方式、设施、位置评分、评分分布、评价话题,以及各预订网站的报价。

Google Hotel Details API

各预订网站报价
评价话题
评分分布
位置评分
每次请求 2 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

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,以单行结果读取这家酒店。

  1. 向 /v1/google-hotels/hotel-details 发送 {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 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 的比例来读。

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

  • Google Hotels API — 按目的地搜索 Google Hotels,返回每家酒店在所选日期的每晚价格、星级、住客评分、评论数、坐标和酒店 ID。
  • Hotel Price Tracker API — 按酒店 ID 获取单个酒店在 Google Hotels 上的价格日历,给出未来约 6–8 周内每个入住日期的最低每晚价格。

探索其他平台

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

Google Hotel Details API — 常见问题

Google Hotel Details API 是一个按酒店 ID 读取 Google 酒店详情的 API,返回联系方式、设施、位置评分、评分分布、评价话题、其他点评网站评分,以及每个预订网站的报价。

Google Hotels API 返回的每一行都在 id 字段里带着酒店 ID,把这个值作为 hotel_id 传入即可。

offers 列出 Google 酒店为这次入住展示的预订网站;酒店官网参与报价时也会出现,并以 is_official 标出。

rating_distribution 给出各星级评价的分布,review_topics 统计每个话题的正负面提及数,other_reviews 补充外部点评网站的评分和一段评价摘录。

每次请求计 2 积分,返回与所传 hotel_id 对应的酒店。