提供一至三个关键词、受支持的地区与语言代码，以及简短请求标签，查询 DataForSEO 标准化搜索量估算值。返回的关键词记录还可包含带有年月标记的月度数据。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
提供一至三个关键词、受支持的地区与语言代码，以及简短请求标签，查询 DataForSEO 标准化搜索量估算值。返回的关键词记录还可包含带有年月标记的月度数据。
获取所选地区与语言下可用的关键词记录。每条记录可包含实际返回的关键词、DataForSEO 搜索量估算、数据来源标记，以及注明年月的月度数值。Agent 可以按实际返回的词语和统计月份，整理你提供的几个短语进行比较。
比较[美国]地区使用[英语]搜索[咖啡豆]和[研磨咖啡]的情况。按每个词语列出可查到的月度估算并标明缺失信息；说明这些数字只是估算，不是所有真实搜索的精确数量，也不是网站访问量。
不保证每个输入词或每个历史月份都有记录，词语也可能转为小写或被修正。这些是供应商估算值，不是直接的 Google Ads 计数或网站访问量。主要搜索量数值没有明确的平均周期；月度记录也不保证覆盖十二个月或当前月份。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
关键词搜索量请求request | object | 必填 | 必填对象，tag、keywords、language_code、location_code 四项都要提供，用于指定地区与语言的查询。
|
请求标签request.tag | string | 必填 | 必填非空字符串，Toolmu 接受 1–256 个字符。为符合供应商要求，使用 1–255 个字符，例如 coffee-check。它标记请求，不保证在关键词结果中回传。
|
要查询的关键词request.keywords | array | 必填 | 必填数组，含一至三个关键词字符串。这些是要查询的短语，不是用来发现新词的种子；不保证每个输入短语都有返回记录。
|
单个关键词短语request.keywords[] | string | — | 每项为非空 UTF-8 字符串，Toolmu 接受 1–256 个字符；为符合供应商要求，使用 3–256 个字符，部分符号受到限制。供应商会转成小写，也可能修正拼写。
|
搜索语言代码request.language_code | string | 必填 | 必填非空代码字符串，长度 1–256 个字符。地区和语言组合须受供应商支持；en 是英语示例，不是默认值。填写代码，不填完整语言名称。
|
搜索地区代码request.location_code | integer | 必填 | 必填整数，范围 1–100000000，且必须是供应商支持的地区代码。2840 是美国示例，不是默认值；数值在范围内不代表该地区受支持。
|
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"location_code",
"language_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
},
"language_code": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"location_code": {
"type": "integer",
"maximum": 100000000,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
供应商的数据来源标记与月度数值说明见 DataForSEO 搜索量文档。
直接填写国家和语言名称，例如[美国]和[英语]。
比较[美国]地区使用[英语]搜索[咖啡豆]和[研磨咖啡]的情况。按每个词语列出可查到的月度估算并标明缺失信息；说明这些数字只是估算，不是所有真实搜索的精确数量，也不是网站访问量。
把查询的词语、月份和对应数字放在一起。某些词语或月份可能没有结果，请说明没有查到，不要当成 0。这些数字是搜索情况估算，不是每次搜索的精确数量，也不是网站访问量。
本工具没有数据来源选择参数。供应商文档的默认设置是用 clickstream 计算标准化 DataForSEO 搜索量；有返回来源标记时，应按实际标记解读。拼写校验可能使用 Google Ads 功能，但这不代表搜索量估算是直接的 Google Ads 计数。
供应商会转成小写，也可能返回修正拼写后的词语。应按实际返回的关键词对应记录，不假定仍按输入顺序排列。没有记录或数值时含义未知，不应补零；明确报告的零要单独保留。
每条月度数据有自己的年份和月份，不保证连续十二个月都有数据，也不保证包含当前月份。这里没有明确主要搜索量数值的平均周期，不应称其为十二个月平均值。历史记录和主要数值都不是未来预测。
标签通过必填 tag 发送。使用 coffee-check 这样的简短值，长度为 1–255 个字符；供应商上限比 Toolmu 的 256 字符更窄。标签用于标记请求，但不保证在关键词结果中回传。
搜索量估算不衡量你的网站访问、独立搜索人数或销售额。可在相同地区与语言下，按实际返回且可比较的记录查看估算。本查询不生成新关键词，也不返回自然排名、广告每次点击费用或关键词难度。