提供 1–3 个关键词、受支持的地区代码和简短请求标签，让 Agent 查询 DataForSEO 基于点击流数据的月搜索量估算，以及实际返回关键词的可用历史。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
提供 1–3 个关键词、受支持的地区代码和简短请求标签，让 Agent 查询 DataForSEO 基于点击流数据的月搜索量估算，以及实际返回关键词的可用历史。
获取所选地区的关键词记录，查看可用的平均月搜索量估算，以及标有年份和月份的历史数据。Agent 可以比较实际返回的词，并整理已返回时段的变化。
比较[跑步鞋]和[越野跑步鞋]在[美国]每月大约有多少人搜索，并展示能查到的历史记录。如果某个月没有资料，请说明暂时查不到，不要把它写成 0。把这次查询命名为[鞋类比较]。
可用历史最长覆盖过去 12 个月，但不保证每个词都有记录，也不保证历史完整或最新。这些估算不是你的广告账户数据，不能预测网站访问量；缺失值应与明确返回的零区分。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
关键词搜索量请求request | object | 必填 | 须提供 keywords、location_code 和 tag 三项属性；每次为一个受支持地区查询一组已提供的关键词。
|
请求标签request.tag | string | 必填 | 此请求的必填标签，不是搜索筛选条件。为符合供应商限制，请用 1–255 个字符；工具字段允许 1–256 个字符，但 256 字符的标签可能被上游拒绝。返回的关键词集合不保证带有此标签。
|
待查询关键词request.keywords | array | 必填 | 提供 1–3 个已有词语，查询其搜索量估算，不会生成新词。每个词须符合供应商的文字限制。
|
关键词内容request.keywords[] | string | — | 每个词建议使用 3–256 个字符。工具字段接受 1–256 个字符，但供应商至少要求 3 个，过短可能被拒绝。输入会转为小写，部分符号和表情不被接受。
|
搜索地区代码request.location_code | integer | 必填 | 供应商支持的地区代码，2840 是美国的示例，不是默认值。工具整数范围为 1–100000000，但须使用实际受支持的代码；没有语言或日期选项。
|
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"location_code",
"tag",
"keywords"
],
"properties": {
"tag": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"maxItems": 3,
"minItems": 1
},
"location_code": {
"type": "integer",
"maximum": 100000000,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
供应商对搜索量估算和月度历史的说明见 DataForSEO Clickstream Search Volume 文档。
填写国家名称，例如[美国]，再给这次查询起个简单名称，例如[鞋类比较]。直接写国家名即可，不用查编号。
比较[跑步鞋]和[越野跑步鞋]在[美国]每月大约有多少人搜索，并展示能查到的历史记录。如果某个月没有资料，请说明暂时查不到，不要把它写成 0。把这次查询命名为[鞋类比较]。
这些数字是人们每月搜索这些词的次数估算，不代表你的广告效果或网站访问人数。有些月份可能查不到资料，这不代表没人搜索。
此工具一次接受 1–3 个词，并查询一个受支持地区。它查询已提供的词，不负责发现新词。
DataForSEO 根据点击流观察数据进行推算，得到平均月搜索量估算。这不是 Google Ads 搜索量、广告账户的点击或展示，也不是独立用户人数。可用来比较不同词的估算搜索量，不能据此预测自己的网站流量。
没有日期或历史长度选项。返回的年、月记录可能覆盖过去最多 12 个月，可用范围取决于关键词和地区。请看实际年月标签；不保证历史完整，也不保证包含当前月份。
建议使用 3–256 字符的普通词语，以及 1–255 字符的简短标签。工具字段也接受更短的词和 256 字符的标签，但这些可能不符合供应商限制。供应商会把关键词转为小写，并限制部分符号。标签用于标记请求，不是关键词筛选条件，也不保证作为输出字段返回。
按返回的关键词名称对应记录，不要按输入顺序对齐；名称可能经过供应商的小写或解码处理。缺失与 null 应和明确返回的零分开；没有记录不能说明该词无人搜索。返回记录数不是搜索次数，也不代表每个输入词都有数据。