Google Events SERP：概览

本接口用于获取 Google Events 搜索结果数据。返回结果与提交的、地理位置等参数相匹支持英文语言环境。

本页涉及的 Google V2 SERP 接口路径如下：

• 实时高级查询：POST /v3/serp/google/v2/live/advanced/
• 标准任务提交：POST /v3/serp/google/v2/task_post/
• 标准任务结果获取：GET /v3/serp/google/v2/task_get/advanced/

结果准确性

本平台会尽可能准确地模拟指定的搜索引擎和地理位置，使返回结果与任务创建时对应参数下的搜索结果保持一致。

响应中的 check_url 可用于复核搜索结果。建议在无痕模式下访问该地址，以确认返回数据是否与目标搜索环境一致。

系统不会使用用户偏好、搜索历史及个性化因素，因此这些因素不会反映在返回的 SERP 结果中。

支持的设备和操作系统

Google Events SERP API 支持 desktop 设备类型。

创建任务时，可以指定以下操作系统：

• Windows
• macOS

支持英文语言环境。

Google V2 SERP 高级接口

Google V2 SERP 高级接口用于获取指定和地理位置下的搜索结果，默认返回前 10 条搜索结果。

接口路径：

POST /v3/serp/google/v2/live/advanced/

如需使用标准任务模式，请使用以下接口：

POST /v3/serp/google/v2/task_post/
GET /v3/serp/google/v2/task_get/advanced/

数据获取方式

本平台提供两种 SERP 数据获取方式：实时方式和标准方式。

实时方式

实时方式适用于需要立即获取搜索结果的场景。

与标准方式不同，实时方式无需分别调用任务提交接口和结果获取接口。提交请求后，接口会直接返回对应的 SERP 数据。

接口：

POST /v3/serp/google/v2/live/advanced/

实时方式的请求成本通常高于标准方式。

标准方式

标准方式适用于不要求实时返回结果的场景，价格通常更低。

调用流程如下：

1. 通过以下接口提交任务：

   POST /v3/serp/google/v2/task_post/

2. 等任务完成。

3. 通过以下接口获取任务结果：

   GET /v3/serp/google/v2/task_get/advanced/

标准方式支持以下任务完成通知机制：

• pingback_url：任务完成后通知指定地址。
• postback_url：任务完成后将结果发送到指定地址。

使用 postback_url 时，还需要指定用于获取数据的 advanced 函数。

如果使用标准方式时未设置 pingback_url 或 postback_url，可以通过“任务就绪”接口获取所有已完成但尚未提取的任务 ID，再调用任务结果接口获取数据。

认证示例

curl --request POST \
  --url https://api.seermartech.cn/v3/serp/google/v2/live/advanced/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "music events",
      "location_name": "New York, New York, United States",
      "language_name": "English",
      "device": "desktop",
      "os": "windows"
    }
  ]'

> 请求字段及可选值请以对应接口的参数定义为准。

请求限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准POST 和 GET API 请求。

每次 POST 请求最多 100 个任务。

如需提高调用限制，请联系本平台技术支持。

优级与计费

实时方式会立即返回结果，因此通常采用最高计费标准。

标准方式支持两种任务优级，分别代表任务执行速度：

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

任务的扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

depth 对费用的影响

当请求中的 depth 高于默认值时，任务费用会增加。

例如：

• 默认 depth 为 10
• 设置 "depth": 15 时，系统按 20 条结果计费
• 此时任务费用会按 2 倍结果数量计算

计费规则以接口响应中的扣费信息为准。

任务处理建议

• 需要即时展示搜索结果时，使用实时接口 /v3/serp/google/v2/live/advanced/。
• 需要批量采集且对实时性要求较低时，使用标准任务接口。
• 任务量较大时，优使用 postback_url 或 pingback_url，减少轮询请求。
• 未回调地址时，可获取已完成任务 ID，再批量请求任务结果。

实用场景

• 监控本地活动：按城市和采集 Google Events 结果，评估品牌活动在目标地区的搜索可见度。
• 分析竞品活动排名：跟踪竞品名称、活动名称及的 Events 展示，发现竞争对手的活动投放和布局。
• 发现热门活动主题：批量查询不同活动类，分析目标城市的活动类型和搜索需求，为选题与运营策划提供依据。
• 验证本地 SEO 优化效果：定期对比指定在不同城市和操作系统下的 Events SERP 变化，评估本地页面和活动信息优化效果。
• 构建活动报数据集：通过标准任务模式批量采集多个地区的活动搜索结果，为市场研究、区域拓展和营销决策提供结构化数据。