Google Hotels Data APIs
按目的地搜索酒店,查看任意酒店在 Google Hotels 上的完整资料,并获取它的每晚价格日历,三者通过同一个酒店 ID 串联。
可用的 Google Hotels API
先用 Google Hotels API 找到酒店和酒店 ID,再用 Google Hotel Details API 查看单个酒店的资料与报价,或用 Hotel Price Tracker API 查看它按入住日期的价格。
可以获取哪些 Google Hotels 数据?
每一行对应一家酒店或一个晚上,价格使用你指定的货币,酒店 ID 把三个 API 连在一起。
带价格的酒店列表
酒店名称、排名、所选日期的最低每晚价格、是否广告位,以及酒店在 Google Hotels 上的页面链接。
评分与住客评论
星级、1–5 分的住客平均评分、评论数、各星级评分占比,以及按评论主题统计的正面和负面提及。
各预订网站报价
每个卖家的每晚价格和预订链接,并标注酒店官网报价、广告报价和可免费取消的报价。
位置与周边
地址、坐标、所在街区名称,以及游玩、餐饮、交通和机场便利度的 1–5 分评分。
每晚价格日历
单个酒店每个入住日期的最低价格,通常覆盖未来 6–8 周。
选择哪个 Google Hotels API
三个 API 共用同一个酒店 ID,搜索结果可以直接用于详情或价格日历请求。
| API | 输入 | 返回内容 |
|---|---|---|
| Google Hotels API | 在 query 中填写目的地或酒店名称 | 最多 140 家酒店,含每晚价格、星级、评分、评论数、坐标和酒店 ID |
| Google Hotel Details API | 一个 hotel_id | 一行数据,含联系方式、设施、周边评分、评分分布、评论主题和各预订网站报价 |
| Hotel Price Tracker API | 一个 hotel_id | 每个入住日期一行,给出当晚最低价格,通常覆盖未来 6–8 周 |
Google Hotels API 如何工作
三个 API 使用相同的异步任务流程。
1. 搜索酒店
向 /v1/google-hotels/search POST 目的地,保存想继续跟进的酒店 id。
2. 深入查看
把 hotel_id POST 到 /v1/google-hotels/hotel-details 获取资料与报价,或 POST 到 /v1/google-hotels/hotel-prices 获取价格日历。
3. 读取结果
轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded,然后读取 results.items 中的数据。
使用 SocQ API key 认证并提交目的地。每返回一家酒店消耗 0.15 积分。
curl -X POST "https://api.socq.ai/v1/google-hotels/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"hotels in new york","currency":"USD","results_limit":18}'
# Poll GET /v1/tasks/{task_id}
# Read the hotels in results.items常见 Google Hotels API 使用场景
目的地价格基准
在相同日期下按星级和评分比较不同城市的每晚价格。
价格一致性检查
对比酒店官网价格与在线旅行社对同一住宿的报价。
竞品监测
并排跟踪周边酒店的价格日历、评分分布和评论主题。
旅行内容与酒店页面
用地址、设施、入住时间、照片和周边评分充实酒店页面。
行程规划
预订前找出未来几周最便宜的入住日期。
请求规则与计费
以下规则适用于三个 Google Hotels API。
- check_in 和 check_out 需一起提供,格式为 YYYY-MM-DD,从今天起,最长 30 晚;都不填时价格为明天起住一晚。
- 用 USD、EUR 等三位货币代码设置 currency,让不同请求的价格可以直接比较。
- Google Hotels API 每次返回 1–140 家酒店,默认 18 家,每返回一家酒店消耗 0.15 积分。
- Google Hotel Details API 使用搜索结果中的 hotel_id,每次请求消耗 2 积分。
- Hotel Price Tracker API 使用 hotel_id,每次请求消耗 4 积分,返回整份价格日历。
Google Hotels API 常见问题
Google Hotels API 是什么?
Google Hotels API 按目的地搜索 Google Hotels,返回酒店在所选日期的每晚价格、星级、住客评分、评论数、坐标,以及用于后续请求的酒店 ID。
有哪些 Google Hotels API 可用?
用于搜索的 Google Hotels API、用于查看单个酒店资料和各预订网站报价的 Google Hotel Details API,以及按入住日期查看价格的 Hotel Price Tracker API。
hotel_id 从哪里来?
Google Hotels API 返回的每一行都在 id 字段中带有酒店 ID,把这个值作为 hotel_id 传给详情和价格日历 API 即可。
价格对应哪些日期?
搜索和详情使用你填写的 check_in 和 check_out,最长 30 晚;两者都不填时为明天起住一晚。价格日历按入住日期每晚一行,覆盖约 6–8 周。
Google Hotels 请求如何计费?
搜索按每返回一家酒店 0.15 积分计费,酒店详情每次请求 2 积分,价格日历每次请求 4 积分。
结合多平台数据,获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来,帮助你持续跟踪品牌、达人和话题表现,更高效地完成跨平台监测与分析。
Brand Monitoring API
查找提及某个品牌、产品或话题的网页,为每个网页打出情感和情绪评分,并汇总全网如何谈论它。
AI Search API
追踪 AI 概览、ChatGPT 和 Google AI 模式如何回答你所在市场的问题:哪些回答点名了你的品牌、你的可见度有多高,以及它们引用了哪些域名和页面。
Instagram API
通过统一异步流程查询已知 username 或发现公开主页,并采集粉丝列表记录、关注关系、账号发布的帖子、标记主页的帖子、hashtag 结果、Reels、字幕文本、评论、账号计数、互动指标和媒体元数据。
TikTok API
通过统一异步流程采集受支持的 TikTok 公开资料、直接视频元数据、顶级评论、视频搜索结果和指定标签下的视频。
YouTube API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、关键词与话题标签结果和可用字幕。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕,获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。


