Google 自动补 API：概览

Google 自动补 API 用于获取搜索框时的联想词建议。返回结果会根据以下条件变化：

• 搜索
• language：语言
• location：地理位置
• cursor_pointer：标位置
• client：客户端类型

如需验证返回结果是否符合预期，可在无痕模式下访问响应中的 check_url。本平台不会使用用户偏好、搜索历史及个性化因素，因此这些因素不会反映在返回的结果中。

API 功能

Google 自动补 API 支持通过 advanced 函数获取建议结果：

• advanced：返回结构化的高级结果

对应结果获取路径：

/v3/serp/google/autocomplete/task_get/advanced/

请求方式

本接口支持两种任务获取方式：实时方式（Live）和标准方式（Standard）。

实时方式

实时方式适用于需要立即获取建议结果的场景。该方式会在单次请求中完成任务提交和结果返回，不需要分别调用任务提交和任务获取接口。

实时高级接口路径：

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

标准方式

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

1. 通过 POST 接口提交任务。
2. 等本平台完成任务处理。
3. 通过 GET 接口获取结果。

任务提交接口：

/v3/serp/google/v2/task_post/

高级结果获取接口：

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

如果不需要实时获取结果，可以在提交任务时设置以下回调参数：

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

使用 postback_url 时，还需要指定结果处理函数：

• advanced
• html

如果使用标准方式提交任务，且未设置 pingback_url 或 postback_url，可以调用 Tasks Ready 接口，获取所有已完成但尚未取回的任务 ID，再通过 Task GET 接口获取对应结果。

主要参数

参数	类型	说明
keyword	string	用于获取联想词的搜索。
language	string	返回建议所使用的语言。可参考语言列表接口：/v3/serp/google/languages/。
location	string / integer	搜索地域。可参考地域列表接口：/v3/serp/google/locations/。
cursor_pointer	string / integer	指定搜索框中的标位置，影响自动补建议的生成结果。
client	string	指定 Google 搜索客户端类型，可能影响返回的建议结果。
pingback_url	string	任务完成后的回调地址。
postback_url	string	用于接收任务结果的回调地址。使用该参数时，还需指定 advanced 或 html 函数。

语言和地域参数会直接影响联想词结果，建议根据目标市场明确设置，不要依赖默认值。

请求限制

本平台对 POST 和 GET 请求合计限制如下：

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

• 每次 POST 请求最多提交 100 个任务。
• 如需提升调用限制，请联系平台技术支持。

计费说明

实时方式会即时返回结果，因此通常对应较高的请求成本。

标准方式提供两种任务优级：

1. Normal：普通优级。
2. High：高优级，任务处理速度更快。

标准方式的费用会根据任务优级及请求参数计算。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

认证示例

curl --request POST \
  --url https://api.seermartech.cn/v3/serp/google/v2/task_post/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "seo tools",
      "language": "English",
      "location": "United States",
      "function": "advanced"
    }
  ]'

接口路径

用途	路径
Google 语言列表	/v3/serp/google/languages/
Google 地域列表	/v3/serp/google/locations/
标准方式提交任务	/v3/serp/google/v2/task_post/
标准方式获取高级结果	/v3/serp/google/v2/task_get/advanced/
实时方式获取高级结果	/v3/serp/google/v2/live/advanced/
自动补高级结果获取	/v3/serp/google/autocomplete/task_get/advanced/
沙盒测试	/v3/appendix/sandbox/

实用场景

• 挖掘长尾：批量获取 Google 联想词，扩展 SEO 库并发现用户真实搜索表达。
• 构建选题：按语言和地域采集自动补建议，为博客、落地页和问答生成选题。
• 分析市场差异：使用不同的 location 和 language 获取区域化建议，比较不同市场的搜索需求。
• 优化分组：结合 cursor_pointer 和 client 参数获取更贴近过程的联想结果，提升聚类与意图识别准确度。
• 监测搜索趋势：定期采集重点的联想词变化，识别新需求并及时调整 SEO策略。