Docs
搜索文档...⌘K

Overview

API + MCP
GET/v3/keywords-explorer/overview

在此请求中使用 regex 过滤器时,其功能有限,且语法与其他请求不同。它将星号 (*) 视为通配符。

查询参数

timeoutinteger

手动超时时长(秒)。

limitinteger

要返回的结果数量。

默认:1000
order_bystring

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

Example:field_a,field_b:asc,field_c:desc
wherestring

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

selectstring必填

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

volume_monthly_date_tostring (date)

用于在 volume_monthly_history 字段中获取历史每月搜索量的结束日期,格式为 YYYY-MM-DD。仅在请求 volume_monthly_history 时为必填。

volume_monthly_date_fromstring (date)

用于在 volume_monthly_history 字段中获取历史每月搜索量的开始日期,格式为 YYYY-MM-DD。仅在请求 volume_monthly_history 时为必填。

target_modestring

你指定的目标 URL 的范围。

允许的值:exactprefixdomainsubdomains
targetstring (url)

搜索目标:域名或 URL。

target_positionstring

根据指定 target 的排名位置筛选关键词。

允许的值:in_top10in_top100
countrystring必填

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

允许的值:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
keywordsstring

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

keyword_list_idinteger

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

outputstring

输出格式。

允许的值:jsonphpxml

响应

keywordsarray<object>
clicksinteger or null

用户在搜索目标关键词时,每月在搜索结果页的平均点击次数。

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 个单位) 指示用户搜索查询背后的目的。对象字段:informationalnavigationalcommercialtransactionalbrandedlocal。所有字段类型均为 bool,可能的取值为 truefalse

keywordstring
parent_topicstring or null

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

parent_volumeinteger or null

(10 个单位) 父主题的搜索量。

searches_pct_clicks_organic_and_paidnumber (float) or null

在搜索目标关键词时,点击自然结果和付费结果的用户月平均占比。

searches_pct_clicks_organic_onlynumber (float) or null

在搜索目标关键词时,仅点击自然结果的用户月平均占比。

searches_pct_clicks_paid_onlynumber (float) 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 参数中

volume_monthly_historyarray<object>

(每个历史月份 2 个单位,最低 50 个单位) 在 volume_monthly_date_fromvolume_monthly_date_to 参数设定的时间范围内,关键词历史月度搜索量的估算。