根据搜索词及国家/地区、语言名称获取 Google 自动补全建议。示例使用 Google 搜索结果页；助手会匹配受支持的设置。建议词可用于拓展想法，但不代表搜索量或热门程度。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
根据搜索词及国家/地区、语言名称获取 Google 自动补全建议。示例使用 Google 搜索结果页；助手会匹配受支持的设置。建议词可用于拓展想法，但不代表搜索量或热门程度。
查看实际返回的建议词、可用的搜索链接和排列位置。Agent 可以整理这些候选查询，供后续进一步评估关键词。
查看 Google 搜索框在输入[Albert Einstein]时给出的自动补全建议，地区选[美国]、语言选[英语]。列出建议内容和可用链接。
建议受所选客户端、地区和语言影响，可能重复种子词。列表不保证每项唯一或覆盖全部建议，部分详情可能缺失。这些候选查询不含月搜索量、关键词难度或网页排名，也不保证与登录账号看到的建议一致。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
自动补全请求request | object | 必填 | 必填完整对象，包含 client、keyword、language_code、location_code 四项。一次提供全部输入，工具会返回对应的完整自动补全结果。
|
搜索客户端request.client | string | 必填 | 必填非空字符串，长度 1–256 字符。使用文档列出的客户端代码，例如 Google 搜索首页的 gws-wiz、搜索结果页的 gws-wiz-serp 或 Chrome 地址栏的 chrome-omni。客户端会影响建议和可用详情，不会根据你的浏览器自动选择。
|
种子搜索词request.keyword | string | 必填 | 必填非空字符串，长度 1–256 字符。补全位置为种子词末尾，不能指定光标位置。供应商会解码百分号转义，并将加号视为空格；字面加号提交为 %2B，字面百分号提交为 %25，提交后的字符串仍须不超过 256 字符。
|
语言代码request.language_code | string | 必填 | 必填非空字符串，长度 1–256 字符，须为供应商支持的 Google SERP 语言代码。英语代码 en 只是示例，不是默认值。请提供代码，而非语言名称。
|
地区代码request.location_code | integer | 必填 | 必填整数，范围 1–100000000，且须在供应商支持的 Google SERP 地区列表中。美国代码 2840 是示例，不是默认值；整数处于范围内并不代表该地区代码受支持。
|
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"language_code",
"location_code",
"keyword",
"client"
],
"properties": {
"client": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"keyword": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"language_code": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"location_code": {
"type": "integer",
"maximum": 100000000,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
补全位置默认为种子词末尾，不能选择从词中间开始补全。建议所附的搜索链接可用于进一步查看该查询，但不表示已经执行搜索或评估过搜索需求。
地区选[美国]、语言选[英语]，其余查询步骤由助手处理。
查看 Google 搜索框在输入[Albert Einstein]时给出的自动补全建议，地区选[美国]、语言选[英语]。列出建议内容和可用链接。
这些建议只是 Google 为本次搜索提供的相关方向，不代表搜索次数或热门程度；可用链接可帮助进一步查看。
不是。rank_group 表示同类元素中的位置，rank_absolute 表示本次自动补全结果所有元素中的位置。它们描述返回建议的排列顺序，不是网站的自然搜索排名，也不能替代后续的搜索结果分析。
DataForSEO 用 500–2000 的数值表示建议与种子词的相关程度，值越高表示越相关。该字段适用于 chrome、chrome-omni 客户端，也可能缺失或为 null。它不是搜索量、关键词难度或热度，更不能证明某个关键词一定有效。
建议可能重复种子词或其他条目，不能视为已经去重的列表。items_count 是返回条目数，不是新增且唯一的关键词数量。供应商报告的总体结果数采用另一个口径；即使那里为 0，也不能忽略已经返回的建议列表。
它是 DataForSEO 收到结果的 UTC 时间，不是预测时间、建议发布时间或测得搜索次数的日期。建议可能变化，一次结果不能证明长期顺序固定。
附加详情取决于客户端及供应商实际返回的信息。缩略图、高亮文字和进一步细化查询的选项都不保证出现；缺失或 null 不表示没有建议。保留本次输入的客户端信息，不要自行补齐未返回的详情。