商业数据 API：Google 概览

本页为商业数据 API 的功能概览，不定义单一 API 方法或 /v3/... 主接口路径。各端点用于获取披露的企业实体信息，数据目前主要来自 Google 搜索、Google Hotels 和 Google My Business 等页面与服务。

本接口提供与企业实体、、商家动态及评论的数据，可用于本地搜索、比价、商家信息维护和口碑分析等场景。

功能范围

商业数据 API含以下五类端点能力：

数据类别	主要能力
Hotel Searches	查询符合条件的列表及搜索结果数据
Hotel Info	获取指定的详细资料
My Business Info	获取商家资料页中的基础信息
My Business Updates	获取商家发布的动态
Google Reviews	获取商家知识图谱评论区中的评论数据

Google Hotels

Hotel Searches

从 Google Hotels 搜索结果中获取与请求条件匹的信息：

• 符合查询条件的列表；
• 每家的地理坐标；
• 星级评分与评论信息；
• 房价和价格信息； -店图片。

Hotel Info

获取指定在 Google Hotels 中展示的详细信息：

• 地理位置及排名；
• 用户评论和客户评分；
• 可用设施与服务；
• 价格。

Google My Business

My Business Info

获取商家资料页中的信息：

• 商家名称和描述；
• 服务分类；
• 已提供及未提供的服务属性；
• 联系电话；
• 网站域名；
• 营业时间和繁忙时段。

My Business Updates

获取商家资料页发布的动态：

• 纯文本；
• 帖子 URL；
• 图片 URL；
• 发布信息；
• 发布日期和时间戳；
• 链接 URL 与锚文本。

Google Reviews

获取搜索结果知识图谱中“评论”区域的评论数据：

• 评论正文；
• 提交时间；
• 评分；
• 商家所有回复；
• 评论资料信息。

设置任务

返回结果取决于指定的企业实体或搜索查询、搜索引擎、地点和语言参数。

地点和语言的可用值请参考以下接口：

• 地点：/v3/business_data/google/locations/
• 语言：/v3/business_data/google/languages/

企业实体标识

不同端点使用不同的企业或标识参数：

端点类型	标识参数	说明
My Business、Google Reviews	cid	商家或企业实体的客户端标识符
Google Hotels	hotel_identifier	店标识符

本平台会尽可能模拟指定地点和搜索引擎环境，以使返回结果接近任务创建时对应参数下的搜索结果。

响应中的 check_url 可用于人工核验结果。建议在浏览器无痕模式下访问该地址，以减少本地搜索历史和个性化设置的影响。

> 本接口不会模拟用户偏好、搜索历史或个性化搜索因素，因此这些因素不会反映在返回结果中。

数据获取方式

实时模式（Live）

Google Hotels、Google My Business Info 和 Questions And Answers 端点支持实时模式。

实时模式适用于需要即时返回结果的系统，无需分别提交 POST 任务和发起 GET 请求获取结果。

标准模式（Standard）

所有商业数据 API 端点均支持标准模式。该模式需要执行以下流程：

1. 通过 POST 请求创建任务；
2. 等平台采集数据；
3. 通过 GET 请求获取任务结果。

创建任务时，也可以指定以下回调参数：

参数	说明
pingback_url	任务完成后通知指定地址
postback_url	任务完成后将结果主动推送至指定地址

如果未设置 pingback_url 或 postback_url，可通过 Tasks Ready 端点获取已完成但尚未领取结果的任务 id 列表，再通过对应的 Task GET 端点查询任务结果。

请求限制

商业数据 API 的调用限制如下：

限制项	上限
POST 与 GET 请求总量	每分钟最多 2,000 次
单次 POST 请求中的任务数	最多 100 个

如需提升调用限额，请联系技术支持。

优级与计费

商业数据 API 支持两种任务优级：

1. 普通优级（Normal priority）
2. 高优级（High priority）

高优级通常更快的任务执行速度，对应费用也更高。实时模式（Live）的任务创建费用最高。

不同端点、优级和数据获取方式的费用可能不同。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

实用场景

• 监测本地商家资料：批量获取商家名称、营业时间、电话、网站和服务属性，本地 SEO 信息一致性维护。
• 分析搜索竞争格局：查询指定地点和条件下的列表、排名、评分及价格，识别搜索结果中的竞争对手。
• 追踪商家动态发布：采集商家动态、图片和链接，评估门店活动、运营与竞品促销节奏。
• 挖掘用户评论反馈：获取评论正文、评分和商家回复，识别服务问题、用户诉求及口碑变化趋势。
• 构建本地商业报库：按地点、行业或品牌聚合企业资料，为选址评估、市场调研和销售线索筛选提供数据支持。