主题
商业数据 - Google店：概述
Google店功能用于获取 Google Hotels 中的搜索结果及实体。通过、地点、语言及 POST 参数，本接口可返回结构化 JSON 数据；部分功能还支持返回非结构化 HTML 页面。
Google店两类端点：
- 搜索（Hotel Searches）：获取符合检索条件的列表及搜索结果数据。
- （Hotel Info）：获取指定实体在 Google Hotels 中的完整资料。
##店搜索
搜索端点用于获取 Google Hotels 搜索结果页中的数据，主要：
- 与请求条件匹的列表；
- 各的地理坐标；
- 星级、用户评分及评论信息；
- 房价及价格信息； -店图片。
搜索结果中的数量通常受 depth 参数控制。该类接口按搜索结果中返回的实体数量计费，通常以每 12 个实体为一个计费单位。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
##店
端点用于查询 Google Hotels 中已存在的特定实体，可获取以下结构化信息：
-店位置、地址及搜索排名信息；
- 用户评论和客户评分；
- 房价、价格趋势及价格。
支持的数据返回方式
Google店提供以下两种数据获取方式。
Advanced
advanced 功能同时适用于搜索和端点，返回结构化 JSON 数据，适合直接用于程序处理、数据仓库同步或报表系统。
HTML
html 功能适用于端点，返回非结构化 HTML，适合需要解析或存档原始页面的场景。
数据获取模式
本接口支持 Standard 和 Live 两种数据获取模式。
Standard 模式
Standard 模式采用异步任务机制，通常需要提交任务，再单独请求任务结果。该模式适用于对实时性要求不高、希望降低请求成本的批量采集场景。
Standard 模式支持两种任务优级：
- 普通优级（Normal）：适合常规批量任务。
- 高优级（High）：以更高的执行优级处理任务。
如果提交 Standard 任务时未设置回调地址，可按以下流程获取结果：
- 提交任务；
- 通过 Tasks Ready 端点获取已完成但尚未读取的任务 ID；
- 使用对应的 Task GET 端点获取任务结果。
如需查询账户用量或余额数据，可使用容路径：
/v3/appendix/user_data/?php
Live 模式
Live 模式在单次请求中直接返回结果，无需分别提交任务和轮询获取结果，适合需要即时响应的业务场景，例如用户在比价页面发起实时检索。
Live 模式的任务设置成本通常高于 Standard 模式。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
回调通知
使用 Standard 模式创建任务时，可选以下回调字段：
| 字段 | 说明 |
|---|---|
pingback_url | 任务完成后向指定地址发送完成通知。 |
postback_url | 任务完成后将结果直接推送至指定地址。 |
使用 postback_url 时，同时指定数据返回功能，即：
advanced：推送结构化 JSON 结果；html：推送 HTML 结果适用于功能。
建议回调服务备幂等处理能力，并根据任务 ID 去重，重复通知导致重复写数据。
请求限制
| 限制项 | 限制 |
|---|---|
| 平台限流以认证说明中的 30/60/120 次/分钟规则为准/分钟 | |
| 单个 POST 请求中的任务数 | 最多 100 个任务 |
限制时，请降低请求并发量、实施重试退避策略，或联系技术支持申请提升额。
计费说明
Google店接口的费用取决于以下因素：
- 使用的端点类型：搜索或；
- 数据获取模式：Standard 或 Live；
- Standard 任务优级：普通或高优级； -店搜索任务的
depth设置及返回的实体数量。
：
-店搜索通常根据结果中出现的实体数量计费； -店通常按任务计费；
- Live 模式通常比 Standard 模式成本更高；
- 高优级 Standard 任务通常比普通优级任务成本更高。
扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
实用场景
- 监测竞品排名：按城市、日期和人数检索结果，跟踪自有及竞品在 Google Hotels 中的位置和排名变化。
- 构建实时比价页：通过 Live 模式获取指定目的地的列表、评分和价格，为用户提供实时住宿选择参考。
- 分析目的地供给与价格带：批量采集热门城市的星级、价格和评分，识别不同区域的住宿供给密度及价格区间。
- 完善主数据档案：查询指定实体的地址、坐标、评分、评论和价格，补 CRM、库或平台的数据字段。
- 追踪节假日价格波动：按不同日期重复查询搜索结果，分析节假日、展会或旺季期间的房价变化趋势。