Docs
搜索文档...⌘K

自然搜索关键字

API + MCP
GET/v3/site-explorer/organic-keywords

查询参数

timeoutinteger

手动超时时长(秒)。

limitinteger

要返回的结果数量。

默认:1000
order_bystring

以逗号分隔的列列表,用于对结果排序,可选指定排序方向。有效列标识符请参见响应 Schema。

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

筛选表达式。支持以下列标识符(与 select 参数支持的标识符不同)。

selectstring必填

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

protocolstring

目标的协议。

允许的值:bothhttphttps
默认:both
targetstring (url)必填

搜索目标:域名或 URL。

modestring

基于你输入的目标所确定的搜索范围。

允许的值:exactprefixdomainsubdomains
默认:subdomains
countrystring

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

允许的值:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
date_comparedstring (date)

用于对比指标的日期,格式为 YYYY-MM-DD。

datestring (date)必填

用于报告指标的日期,格式为 YYYY-MM-DD。

volume_modestring

搜索量计算模式:按月或按平均值。它会影响搜索量、流量和流量价值。

允许的值:monthlyaverage
默认:monthly
outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

keywordsarray<object>
all_positionsarray<object>

(5 个单位) 关键词的所有排名列表。

all_positions_prevarray<object>

(5 个单位) 对比日期该关键词的所有排名列表。

best_positioninteger or null

目标在某个关键词的自然搜索结果中排名最高的位置。

best_position_diffinteger or null

所选日期之间的排名位置变化。

best_position_has_thumbnailboolean or null

最高排名带有缩略图。

best_position_has_thumbnail_prevboolean or null

在对比日期,最高排名带有缩略图。

best_position_has_videoboolean or null

最高排名带有视频。

best_position_has_video_prevboolean or null

在对比日期,最高排名带有视频。

best_position_kindstring or null

最高排名的类型:自然、付费或 SERP 特性。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_mergedstring

针对排序优化的最高排名类型。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_prevstring or null

在对比日期,最高排名的类型。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_previnteger or null

在对比日期的最高排名。

best_position_setstring

最高排名所属的排名分组。

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_set_prevstring or null

在对比日期,最高排名所属的排名分组。

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_urlstring (url) or null

自然搜索结果中的排名 URL。

best_position_url_prevstring (url) or null

对比日期的排名 URL。

cpcinteger or null

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

cpc_mergedinteger or null

用于排序优化的 CPC 字段。

cpc_previnteger or null

对比日期的 CPC 指标。

entitiesarray<object>

在关键词中出现的:组织机构、产品、人物、作品集、事件和地点。

is_best_position_set_top_11_50boolean

最佳排名所属的排名组为 11-50。

is_best_position_set_top_11_50_prevboolean or null

对比日期的最佳排名所属排名组为 11-50。

is_best_position_set_top_3boolean

最佳排名所属的排名组为 Top 3。

is_best_position_set_top_3_prevboolean or null

对比日期的最佳排名所属排名组为 Top 3。

is_best_position_set_top_4_10boolean

最佳排名所属的排名组为 4-10。

is_best_position_set_top_4_10_prevboolean or null

对比日期的最佳排名所属排名组为 4-10。

is_brandedboolean

用户意图:品牌型。用户正在搜索特定品牌或公司名称。

is_commercialboolean

用户意图:商业型。用户正在比较产品或服务,为购买决策做准备。

is_informationalboolean

用户意图:信息型。用户正在查找信息或特定问题的答案。

is_localboolean

用户意图:本地型。用户正在查找与特定地点或附近服务相关的信息。

is_navigationalboolean

用户意图:导航型。用户正在查找特定的网站或网页。

is_transactionalboolean

用户意图:交易型。用户已准备好完成某项操作,通常是购买行为。

keywordstring or null

你的目标对象排名所对应的关键词。

keyword_countrystring

你的目标对象排名所对应关键词的所属国家/地区。

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
keyword_difficultyinteger or null

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

keyword_difficulty_mergedinteger or null

(10 单位)用于排序优化的关键词难度字段。

keyword_difficulty_previnteger or null

(10 单位)对比日期的关键词难度。

keyword_languagearray<string>

搜索查询的语言

keyword_mergedstring

用于排序优化的关键词字段。

keyword_prevstring or null

对比日期时你的目标对象排名所对应的关键词。

languagestring

SERP 语言。

language_prevstring or null

对比日期的 SERP 语言。

last_updatestring (date-time)

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

last_update_prevstring (date-time) or null

截至对比日期,我们检查搜索引擎结果的日期。

serp_featuresarray<string>

某个关键词在搜索结果中显示的SERP特性。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_countinteger

某个关键词在搜索结果中显示的 SERP 特性数量。

serp_features_count_previnteger or null

对比日期的 SERP 特性数量。

serp_features_mergedarray<string>

用于排序优化的 SERP 特性字段。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<string>

对比日期某个关键词在搜索结果中显示的 SERP 特性。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_target_main_positions_countinteger

某个关键词的目标 URL 排名数量(不包含 Sitelinks、Top stories、Image packs 以及 X (Twitter) 上帖子中的位置)。

serp_target_main_positions_count_previnteger or null

对比日期某个关键词的目标 URL 排名数量(不包含 Sitelinks、Top stories、Image packs 以及 X (Twitter) 上帖子中的位置)。

serp_target_positions_countinteger

某个关键词的目标 URL 排名数量。

serp_target_positions_count_previnteger or null

对比日期某个关键词的目标 URL 排名数量。

statusstring

页面状态:刚开始获得排名的新页面(“left”)、从搜索结果中消失的流失页面(“right”),或无变化(“both”)。

Allowed values:leftrightboth
sum_paid_trafficinteger or null

(10 单位)目标关键词通过付费搜索为您的目标页面带来的预估月访问量。

sum_paid_traffic_mergedinteger

(10 单位)用于排序优化的付费流量字段。

sum_paid_traffic_previnteger or null

(10 单位)对比日期的付费流量。

sum_trafficinteger or null

(10 单位)目标通过自然搜索获得的某关键词预估月访问量。

sum_traffic_mergedinteger

(10 单位)为排序优化的流量字段。

sum_traffic_previnteger or null

(10 单位)对比日期的流量。

volumeinteger or null

(10 单位)最近一个月内关键词搜索次数的估算。

volume_desktop_pctnumber (float) or null

来自桌面设备的搜索量占总搜索量的百分比。

volume_mergedinteger or null

(10 单位)为排序优化的搜索量字段。

volume_mobile_pctnumber (float) or null

来自移动设备的搜索量占总搜索量的百分比。

volume_previnteger or null

(10 单位)对比日期的搜索量。

wordsinteger or null

关键词的词数。

words_mergedinteger

为排序优化的关键词词数。

words_previnteger or null

对比日期的关键词词数。