提供 1–2 个种子词和目标地区，通过 DataForSEO 获取首个返回的 Google Ads 关键词记录及其可用搜索和广告指标，而非完整建议列表。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
提供 1–2 个种子词和目标地区，通过 DataForSEO 获取首个返回的 Google Ads 关键词记录及其可用搜索和广告指标，而非完整建议列表。
按种子词与目标地区查看首个返回的关键词记录。可用详情包括关键词、近似平均月搜索量、以美元计的每次广告点击费用（CPC）、付费广告竞争程度及其 0–100 指数，以及标明年月的月度搜索数据。 让 Agent 解读可用指标，并帮助你判断返回词与目标主题的关系。返回词也可能与种子词相同。
查找与[咖啡豆]相关、适用于[美国]的一条广告搜索词，并说明它每月大约被搜索多少次、一次有人点击广告大约需要多少钱。
此工具只交付一条记录，不提供完整建议列表，也不保证每个种子词都有独立结果。返回词不一定是新词或最佳选择。月度数据可能滞后或缺少月份；搜索量不是点击量、人数或流量预测，付费广告竞争程度也不是自然搜索排名难度。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
关键词查询条件request | object | 必填 | 必填对象，包含种子词数组与支持的地区代码。本次查询须同时提供两项。
|
种子词request.keywords | array | 必填 | 必填数组，包含 1–2 个种子词，用于引导关键词查询。两个种子词不代表各自有独立返回记录。
|
每个种子词request.keywords[] | string | — | 数组中的每项为字符串，工具校验长度为 1–256 字符。为符合供应商要求，实际使用 1–80 字符；供应商会转为小写，Google Ads 不接受部分符号或字符，包括表情。
|
目标地区代码request.location_code | integer | 必填 | 必填且须为 Google Ads 支持的整数地区代码，范围 1–100000000。美国代码 2840 仅作示例，不是默认值；范围内的整数也不一定对应受支持地区。语言和日期不是此工具的输入项。
|
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"location_code",
"keywords"
],
"properties": {
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"maxItems": 2,
"minItems": 1
},
"location_code": {
"type": "integer",
"maximum": 100000000,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
指标定义见 DataForSEO 的 Google Ads 关键词建议说明。让 Agent 整理历史数据时，将返回的年份、月份与对应数值放在一起。
用日常说法写国家或地区，例如：[美国]。直接写地点名称即可；此工具没有单独选择语言的选项。
查找与[咖啡豆]相关、适用于[美国]的一条广告搜索词，并说明它每月大约被搜索多少次、一次有人点击广告大约需要多少钱。
如果查到相关建议，工具会展示其中一条，并说明它每月大约被搜索多少次、一次广告点击可能要花多少钱，以及商家展示广告的竞争情况。部分信息可能缺失或更新较慢。
即使提供两个种子词，此工具也只交付首个返回的关键词记录。它可能与种子词相同，不保证是新词或最佳选择。先确认实际返回词，再解读其指标；这里不提供完整建议列表或每个种子词各一条的对照表。
不是。LOW、MEDIUM、HIGH 分类及可用的 0–100 指数描述付费广告竞争程度。指数反映已填充广告位相对于可用广告位的情况，不表示自然搜索排名难度、获得排名的概率或关键词质量。
CPC 是该关键词报告的每次广告点击费用，以美元计。它与工具当前执行费不同，也不是实时竞价报价、建议出价或广告展示位置保证。其他指标可用时，CPC 仍可能缺失。
搜索量是该词及其地区范围的近似月平均值，不是人数或预期点击量。历史值须结合返回的年份和月份阅读。供应商数据可能滞后于最新月份或缺少部分期间，不保证完整且最新的十二个月数据。null、缺失值与明确报告的 0 要分别保留。
Google Ads 对某些种子词组可能不提供数据。使用 1–2 个普通词语或短语，每个不超过供应商的 80 字符限制；工具自身允许到 256 字符，但较长词条可能被上游拒绝。不支持的符号或表情也可能被拒绝，种子词会转为小写。缺少数据不能证明搜索需求为零或不存在相关词。