Skip to main content
POST
Keyword Search Volume

Keyword Search Volume

请使用本接口支持的语言代码:简体中文为 zh_CN,繁体中文为 zh_TW,不支持 zh。不同 SEO 接口的地区和语言支持范围不同,请以各接口的参数定义为准。 Accepts up to 1,000 keywords. Each returned record corresponds to a keyword for which metrics are available. Similar keywords can occasionally share aggregated search-volume values.

结果字段

任务结果使用下列稳定的 SocQ 字段。来源特有的字段名称和格式会被规范化,但不会推断或补充来源未提供的值。如需请求更小的字段集,MCP 查询请使用 fields,Typed 工具请使用 _result_fields,CLI 请使用 --result-fields。即使值为 null,已声明的字段仍会保留。

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json

请使用本接口支持的语言代码:简体中文为 zh_CN,繁体中文为 zh_TW,不支持 zh。不同 SEO 接口的地区和语言支持范围不同,请以各接口的参数定义为准。

keywords
string[]
必填

Keywords to analyze in one batch,至少提供 1 项,最多提供 1000 项。

Required array length: 1 - 1000 elements
Required string length: 1 - 80
callback_url
string<uri>

可选的任务完成回调 URL。

language
enum<string>

语言代码或语言筛选条件。

可用选项:
Arabic,
Bengali,
Bulgarian,
Catalan,
Chinese (Simplified),
Chinese (Traditional),
Croatian,
Czech,
Danish,
Dutch,
English,
Estonian,
Farsi,
Finnish,
French,
German,
Greek,
Hebrew (old),
Hindi,
Hungarian,
Icelandic,
Indonesian,
Italian,
Japanese,
Korean,
Latvian,
Lithuanian,
Malay,
Norwegian,
Polish,
Portuguese,
Romanian,
Russian,
Serbian,
Slovak,
Slovenian,
Spanish,
Swedish,
Tagalog,
Tamil,
Telugu,
Thai,
Turkish,
Ukrainian,
Urdu,
Vietnamese
Minimum string length: 1
language_code
enum<string>

Language code supported by Keyword Search Volume. Chinese uses zh_CN or zh_TW; zh is not supported. Language sets differ between SEO endpoints.

可用选项:
ar,
bg,
bn,
ca,
cs,
da,
de,
el,
en,
es,
et,
fa,
fi,
fr,
hi,
hr,
hu,
id,
is,
it,
iw,
ja,
ko,
lt,
lv,
ms,
nl,
no,
pl,
pt,
ro,
ru,
sk,
sl,
sr,
sv,
ta,
te,
th,
tl,
tr,
uk,
ur,
vi,
zh_CN,
zh_TW
Required string length: 2 - 10
location_code
integer

Search market location code.

必填范围: x >= 1
location_name
string

Search market location name.

Minimum string length: 1
results_limit
integer

最多保存的结果数,实际结果可能少于该值。

必填范围: 1 <= x <= 2000

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object