自然搜索关键字

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 参数支持的标识符不同）。

best_position：你的目标在某个关键词的自然搜索结果中排名最高的位置。
type: integer nullable

best_position_diff：在你选择的日期之间，排名位置的变化。
type: integer nullable

best_position_has_thumbnail：最高排名位置带有缩略图。
type: boolean nullable

best_position_has_thumbnail_prev：在对比日期，最高排名位置带有缩略图。
type: boolean nullable

best_position_has_video：最高排名位置带有视频。
type: boolean nullable

best_position_has_video_prev：在对比日期，最高排名位置带有视频。
type: boolean nullable

best_position_kind：最高排名位置的类型：自然、付费或 SERP 特性。
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

best_position_kind_merged：为排序优化后的最高排名位置类型。
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

best_position_kind_prev：在对比日期的最高排名位置类型。
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

best_position_prev：在对比日期的最高排名位置。
type: integer nullable

best_position_set：最高排名所属的排名分组。
type: string
enum: "top_3" "top_4_10" "top_11_50" "top_51_more"

best_position_set_prev：在对比日期的最高排名所属的排名分组。
type: string nullable
enum: "top_3" "top_4_10" "top_11_50" "top_51_more"

best_position_url：自然搜索结果中的排名 URL。
type: string nullable

best_position_url_prev：对比日期的排名 URL。
type: string nullable

best_position_url_raw：编码格式的排名页面 URL。
type: string nullable

best_position_url_raw_prev：对比日期的编码格式排名页面 URL。
type: string nullable

cpc：每次点击费用显示广告主在付费搜索结果中为某关键词每次广告点击支付的平均价格，单位为美元分。
type: integer nullable

cpc_merged：为排序优化后的 CPC 字段。
type: integer nullable

cpc_prev：对比日期的 CPC 指标。
type: integer nullable

entities：在关键词中识别到的组织、产品、人物、作品、事件与地点。
type: array(object)

event_entities：在关键词中识别到的事件。
type: array(string)

is_best_position_set_top_11_50：最高排名分组为 11-50。
type: boolean

is_best_position_set_top_11_50_prev：对比日期的最高排名分组为 11-50。
type: boolean nullable

is_best_position_set_top_3：最高排名分组为 Top 3。
type: boolean

is_best_position_set_top_3_prev：对比日期的最高排名分组为 Top 3。
type: boolean nullable

is_best_position_set_top_4_10：最高排名分组为 4-10。
type: boolean

is_best_position_set_top_4_10_prev：对比日期的最高排名分组为 4-10。
type: boolean nullable

is_branded：用户意图：品牌词。用户正在搜索特定品牌或公司名称。
type: boolean

is_commercial：用户意图：商业。用户在购买决策前比较产品或服务。
type: boolean

is_informational：用户意图：信息。用户在寻找信息或某个问题的答案。
type: boolean

is_local：用户意图：本地。用户在寻找与特定地点相关的信息或附近服务。
type: boolean

is_main_position：排除出现在 AI Overview、Sitelinks、Top stories、Image packs、Videos、Discussions and forums 以及 X（Twitter）帖子中的排名位置。
type: boolean

is_main_position_prev：在对比日期，排除出现在 AI Overview、Sitelinks、Top stories、Image packs、Videos、Discussions and forums 以及 X（Twitter）帖子中的排名位置。
type: boolean

is_navigational：用户意图：导航。用户在搜索特定网站或网页。
type: boolean

is_transactional：用户意图：交易。用户准备完成某个行动，通常是购买。
type: boolean

keyword：你的目标正在排名的关键词。
type: string

keyword_country：你的目标正在排名的关键词对应的国家/地区。
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

keyword_difficulty (10 units)：对某个关键词在自然搜索结果 Top 10 排名难度的估计，100 分制。
type: integer nullable

keyword_difficulty_merged (10 units)：为排序优化后的关键词难度字段。
type: integer nullable

keyword_difficulty_prev (10 units)：对比日期的关键词难度。
type: integer nullable

keyword_language：搜索查询的语言
type: array(string)

keyword_merged：为排序优化后的关键词字段。
type: string

keyword_prev：对比日期你的目标正在排名的关键词。
type: string

language：SERP 语言。
type: string

language_prev：对比日期的 SERP 语言。
type: string nullable

last_update：我们上次检查某关键词搜索引擎结果的日期。
type: datetime

last_update_prev：我们在对比日期之前检查搜索引擎结果的日期。
type: datetime nullable

location_entities：在关键词中识别到的地点。
type: array(string)

organisation_entities：在关键词中识别到的组织。
type: array(string)

person_entities：在关键词中识别到的人物。
type: array(string)

position_kind：排名位置的类型：自然、付费或 SERP 特性。在选取最高排名之前，该字段适用于某个关键词与 URL 的所有排名位置。
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

position_kind_prev：对比日期的排名位置类型。
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

positions_kinds：最高排名位置的类型。
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

positions_kinds_prev：对比日期的最高排名位置类型。
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

product_entities：在关键词中识别到的产品。
type: array(string)

serp_features：某关键词搜索结果中出现的 SERP 特性。
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_features_count：某关键词搜索结果中出现的 SERP 特性数量。
type: integer

serp_features_count_prev：对比日期的 SERP 特性数量。
type: integer nullable

serp_features_merged：为排序优化后的 SERP 特性字段。
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_features_prev：对比日期某关键词搜索结果中出现的 SERP 特性。
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_target_main_positions_count：某关键词下的目标 URL 数量（不含 Sitelinks、Top stories、Image packs 以及 X（Twitter）帖子中的排名位置）。
type: integer

serp_target_main_positions_count_prev：对比日期某关键词下的目标 URL 数量（不含 Sitelinks、Top stories、Image packs 以及 X（Twitter）帖子中的排名位置）。
type: integer nullable

serp_target_positions_count：某关键词下的目标 URL 数量。
type: integer

serp_target_positions_count_prev：对比日期某关键词下的目标 URL 数量。
type: integer nullable

status：页面状态：刚开始获得排名的新页面（"left"）、从搜索结果中消失的流失页面（"right"），或无变化（"both"）。
type: string
enum: "left" "right" "both"

sum_paid_traffic (10 units)：估算你的目标从该关键词的付费搜索获得的月访问量。
type: integer nullable

sum_paid_traffic_merged (10 units)：为排序优化后的付费流量字段。
type: integer

sum_paid_traffic_prev (10 units)：对比日期的付费流量。
type: integer nullable

sum_traffic (10 units)：估算你的目标从该关键词的自然搜索获得的月访问量。
type: integer nullable

sum_traffic_merged (10 units)：为排序优化后的流量字段。
type: integer

sum_traffic_prev (10 units)：对比日期的流量。
type: integer nullable

title：某关键词 SERP 中显示的页面标题。
type: string

title_prev：对比日期某关键词 SERP 中显示的页面标题。
type: string

volume (10 units)：对某关键词近一个月搜索量的估计。
type: integer nullable

volume_desktop_pct：总搜索量中来自桌面设备的占比。
type: float nullable

volume_merged (10 units)：为排序优化后的搜索量字段。
type: integer nullable

volume_mobile_pct：总搜索量中来自移动设备的占比。
type: float nullable

volume_prev (10 units)：对比日期的搜索量。
type: integer nullable

words：关键词的词数。
type: integer

words_merged：为排序优化后的关键词词数。
type: integer

words_prev：对比日期的关键词词数。
type: integer

work_entities：在关键词中识别到的作品。
type: array(string)

selectstring必填

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

protocolstring

目标的协议。

允许的值:bothhttphttps

默认:both

targetstring必填

搜索目标：域名或 URL。

modestring

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

允许的值:exactprefixdomainsubdomains

默认:subdomains

countrystring

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

允许的值:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

date_comparedstring

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

datestring必填

用于报告指标的日期，格式为 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

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

best_position_kind_prevstring or null

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

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 or null

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

best_position_url_prevstring 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

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

last_update_prevstring or null

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

serp_featuresarray<string>

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

serp_features_countinteger

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

serp_features_count_previnteger or null

对比日期的 SERP 特性数量。

serp_features_mergedarray<string>

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

serp_features_prevarray<string>

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

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 or null

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

volume_mergedinteger or null

（10 单位）为排序优化的搜索量字段。

volume_mobile_pctnumber or null

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

volume_previnteger or null

（10 单位）对比日期的搜索量。

wordsinteger or null

关键词的词数。

words_mergedinteger

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

words_previnteger or null

对比日期的关键词词数。