搜索建议

API + MCP

GET/v3/keywords-explorer/search-suggestions

查询参数

timeoutinteger

手动超时时长（秒）。

limitinteger

要返回的结果数量。最大值：150000。

默认:1000

order_bystring

用于对结果排序的列。有效的列标识符请参见响应 Schema，但 volume_monthly 除外：该端点的 order_by 不支持它。

Example:field_a,field_b:asc,field_c:desc

wherestring

过滤器表达式。支持以下列标识符（这些标识符不同于 select 参数支持的标识符）。

selectstring必填

要返回的列（逗号分隔）。有效的列标识符请参见响应 Schema。

countrystring必填

两个字母的国家代码（ISO 3166-1 alpha-2）。

允许的值:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

keywordsstring

要显示指标的关键字列表，以英文逗号分隔。

keyword_list_idinteger

要显示指标的现有关联关键字列表的 ID。

outputstring

输出格式。

允许的值:jsonphpxml

响应

keywordsarray<object>

cpcinteger or null

每次点击费用显示的是广告商在付费搜索结果中为某个关键词的每次广告点击所支付的平均价格，以美分计。

cpsnumber (float) or null

每次搜索点击数（或 CPS）是点击与关键词搜索量的比率。它显示了当人们在给定国家/地区搜索目标关键词时，平均有多少个不同的搜索结果被点击。

difficultyinteger or null

（10 单位）以 100 分制估算某关键词在前 10 个自然搜索结果中排名的难度。

first_seenstring (date-time) or null

我们首次检查某关键词搜索引擎结果的日期。

global_volumeinteger or null

(10 个单位) 目标关键词在数据库中所有国家每月平均搜索次数。

intentsobject or null

(10 个单位) 指示用户搜索查询背后的目的。对象字段：informational、navigational、commercial、transactional、branded 或 local。所有字段类型均为 bool，可能的取值为 true 或 false。

keywordstring

parent_topicstring or null

父主题决定是否能通过页面上更一般的主题对目标关键词进行排名。为了识别父主题，我们会提取目标关键词排名第一的页面，并找到为该页面带来最多流量的关键词。

serp_featuresarray<string>

搜索引擎结果页面 (SERP) 上非传统自然搜索结果的丰富结果。

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping

serp_last_updatestring (date-time) or null

上次检查关键词搜索引擎结果的日期。

traffic_potentialinteger or null

(10 个单位) 目标关键词排名第 1 的页面，从其所有排名关键词获得的自然搜索流量总和。

volumeinteger or null

(10 个单位) 基于最近已知的 12 个月数据，对关键词平均每月搜索次数的估算。

volume_desktop_pctnumber (float) or null

在桌面设备上进行的关键词搜索占比。

volume_mobile_pctnumber (float) or null

在移动设备上进行的关键词搜索占比。

volume_monthlyinteger or null

(10 个单位) 对关键词最近一个月搜索次数的估算。该字段可能不会包含在 order_by 参数中