Overview

API + MCP

GET/v3/rank-tracker/overview

对此端点的请求免费，不会消耗任何 API 单位。

查询参数

timeoutinteger

手动超时时长（秒）。

limitinteger

要返回的结果数量。

默认:1000

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

best_position_has_thumbnail：最高排名位置（或目标 URL（如已设置））包含缩略图。 type: boolean nullable

best_position_has_thumbnail_previous：在对比日期，最高排名位置（或目标 URL（如已设置））包含缩略图。 type: boolean nullable

best_position_has_video_preview：最高排名位置（或目标 URL（如已设置））包含视频预览。 type: boolean nullable

best_position_has_video_preview_previous：在对比日期，最高排名位置（或目标 URL（如已设置））包含视频预览。 type: boolean nullable

best_position_kind：最高排名位置（或目标 URL（如已设置））的类型：自然结果、付费结果或 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_previous：在对比日期，最高排名位置（或目标 URL（如已设置））的类型。 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"

clicks：点击指标指用户在搜索目标关键词时，对搜索结果进行点击的平均月次数。有些搜索会点击多个结果，也有些搜索可能完全不会产生点击。 type: integer nullable

clicks_per_search：每次搜索点击数是“点击”与关键词搜索量的比值。它表示在某个国家/地区，用户搜索目标关键词时，平均会点击多少个不同的搜索结果。 type: float nullable

cost_per_click：每次点击费用表示在付费搜索结果中，广告主为某个关键词的每次广告点击所支付的平均价格。 type: integer nullable

country：跟踪某个关键词的国家/地区。两位国家/地区代码（ISO 3166-1 alpha-2）。 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"

country_prev：在对比日期，跟踪某个关键词的国家/地区。两位国家/地区代码（ISO 3166-1 alpha-2）。 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"

created_at：关键词添加到项目的日期。 type: datetime

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_difficulty：关键词排名难度估算：以 100 分制衡量在自然搜索结果前 10 名排名的难度。 type: integer nullable

keyword_has_data：如果关键词仍在处理中且尚未抓取任何 SERP，则返回 false。 type: boolean

keyword_is_frozen：表示关键词是否已超过当前套餐的可跟踪关键词上限。此类关键词会被“冻结”，即不会更新其排名。 type: boolean

keyword_prev：在对比日期，您的目标对象所排名的关键词。 type: string

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

keyword_words_prev：在对比日期，关键词的词数。 type: integer

language：跟踪某个关键词时使用的 SERP 语言。 type: string

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

location：跟踪某个关键词的位置（国家/地区、州/省或城市）。 type: string

location_prev：在对比日期，跟踪某个关键词的位置（国家/地区、州/省或城市）。 type: string

parent_topic：父主题用于判断：在页面上以更通用的主题为目标时，是否仍能为目标关键词获得排名。为识别父主题，我们会选取该关键词排名第 1 的页面，并找出为该页面带来最多流量的关键词。 type: string nullable

position：自然搜索中的最高排名位置（或目标 URL（如已设置））。 type: integer nullable

position_diff：在所选日期之间，最高排名位置（或目标 URL（如已设置））的变化。 type: integer nullable

position_prev：在对比日期，最高排名位置（或目标 URL（如已设置））。 type: integer nullable

search_type_image：搜索类型 Image 表示关键词的图片搜索占比，体现用户对视觉内容的兴趣。 type: float nullable

search_type_news：搜索类型 News 表示关键词的新闻搜索占比。 type: float nullable

search_type_video：搜索类型 Video 表示关键词的视频搜索占比，反映用户对视频内容的兴趣。 type: float nullable

search_type_web：搜索类型 Web 表示关键词的常规网页搜索占比，说明用户对多样信息的需求。 type: float nullable

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_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_updated：我们最近一次检查某个关键词搜索引擎结果的日期。 type: datetime nullable

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

tags：分配给某个关键词的标签列表。 type: array(string)

tags_prev：在对比日期，分配给某个关键词的标签列表。 type: array(string)

target_positions_count：该关键词下参与排名的目标 URL 数量。 type: integer

traffic：页面从自然搜索获得的月访问量估算。根据 "volume_mode" 参数，按最近一个月或最近已知的 12 个月数据进行估算。 type: integer nullable

traffic_diff：在所选日期之间，流量的变化。 type: integer nullable

traffic_prev：页面从自然搜索获得的月访问量估算。根据 "volume_mode" 参数，按最近一个月或最近已知的 12 个月数据进行估算。 type: integer nullable

url：自然搜索中的最高排名 URL（或目标 URL（如已设置））。 type: string nullable

url_prev：在对比日期，自然搜索中的最高排名 URL（或目标 URL（如已设置））。 type: string nullable

volume：关键词的平均月搜索量估算。根据 "volume_mode" 参数，按最近一个月或最近已知的 12 个月数据进行估算。 type: integer nullable

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

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

selectstring必填

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

date_comparedstring

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

datestring必填

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

devicestring必填

在移动端和桌面端排名之间选择。

允许的值:desktopmobile

project_idinteger必填

项目的唯一标识符。您可以在 Ahrefs 中 Rank Tracker 项目的 URL 里找到它：https://app.ahrefs.com/rank-tracker/overview/#project_id#

volume_modestring

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

允许的值:monthlyaverage

默认:monthly

outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

overviewsarray<object>

best_position_has_thumbnailboolean or null

最高排名位置（或目标 URL（如已设置））包含缩略图。

best_position_has_thumbnail_previousboolean or null

在对比日期，最高排名位置（或目标 URL（如已设置））包含缩略图。

best_position_has_video_previewboolean or null

最高排名位置（或目标 URL（如已设置））包含视频预览。

best_position_has_video_preview_previousboolean or null

在对比日期，最高排名位置（或目标 URL（如已设置））包含视频预览。

best_position_kindstring or null

最高排名位置（或目标 URL（如已设置））的类型：自然结果、付费结果或 SERP 特性。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

best_position_kind_previousstring or null

对比日期的最高排名类型（或如已设置，则为目标 URL）。

clicksinteger or null

点击指标指的是人们在搜索目标关键词时，平均每月点击搜索结果的次数。有些搜索会点击多个结果，而有些搜索可能完全没有点击。

clicks_per_searchnumber or null

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

cost_per_clickinteger or null

每次点击成本显示的是广告商在付费搜索结果中为某个关键词的每次广告点击支付的平均价格。

countrystring

跟踪指定关键词的国家/地区。两位字母的国家/地区代码（ISO 3166-1 alpha-2）。

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

country_prevstring

对比日期跟踪指定关键词的国家/地区。两位字母的国家/地区代码（ISO 3166-1 alpha-2）。

created_atstring

关键词被添加至项目的日期。

is_brandedboolean

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

is_commercialboolean

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

is_informationalboolean

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

is_localboolean

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

is_navigationalboolean

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

is_transactionalboolean

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

keywordstring

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

keyword_difficultyinteger or null

关键词难度是指，以 100 分制对一个关键词进入自然搜索结果前 10 名的难度进行的估算。

keyword_has_databoolean

如果关键词仍在处理中且尚未抓取任何 SERP，则返回 false。

keyword_is_frozenboolean

表示关键词是否已超出你套餐的可跟踪关键词上限。此类关键词会被“冻结”，即不会更新其排名。

keyword_prevstring

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

languagestring

跟踪指定关键词时使用的 SERP 语言。

language_prevstring

对比日期的 SERP 语言。

locationstring

跟踪指定关键词的地理位置（国家、州/省或城市）。

location_prevstring

对比日期跟踪指定关键词的地理位置（国家、州/省或城市）。

parent_topicstring or null

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

positioninteger or null

自然搜索中的最高排名（或如已设置，则为目标 URL）。

position_diffinteger or null

所选日期之间最高排名（或如已设置，则为目标 URL）的变化。

position_previnteger or null

对比日期的最高排名（或如已设置，则为目标 URL）。

search_type_imagenumber or null

搜索类型中的“图片”显示了关键词搜索中图片所占的百分比，突显了对视觉内容的关注。

search_type_newsnumber or null

搜索类型中的“新闻”显示了关键词搜索中新闻文章所占的百分比。

search_type_videonumber or null

视频类搜索显示了视频搜索中关键词所占的百分比，体现用户对视频内容的兴趣。

search_type_webnumber or null

搜索类型中的“网页”显示了关键词搜索中一般网页内容所占的百分比，反映出对广泛信息的关注。

serp_featuresarray<string>

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

serp_features_prevarray<string>

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

serp_updatedstring or null

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

serp_updated_prevstring or null

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

tagsarray<string>

分配给某个关键词的标签列表。

tags_prevarray<string>

在对比日期为指定关键词分配的标签列表。

target_positions_countinteger

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

trafficinteger or null

根据“volume_mode”参数，基于最近一个月或最近已知的 12 个月数据，估算页面来自自然搜索的月访问量。

traffic_diffinteger or null

所选日期之间的流量变化。

traffic_previnteger or null

根据“volume_mode”参数，基于最近一个月或最近已知的 12 个月数据，估算页面来自自然搜索的月访问量。

urlstring or null

自然搜索中排名最高的 URL（若已设置目标 URL，则显示目标 URL）。

url_prevstring or null

对比日期中排名最高的 URL（若已设置目标 URL，则显示目标 URL）。

volumeinteger or null

根据“volume_mode”参数，基于最近一个月或最近已知的 12 个月数据，估算关键词的平均每月搜索量。

volume_desktop_pctnumber or null

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

volume_mobile_pctnumber or null