Docs
搜索文档...⌘K

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

selectstring必填

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

date_comparedstring (date)

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

datestring (date)必填

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

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
clicksinteger or null

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

clicks_per_searchnumber (float) or null

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

cost_per_clickinteger or null

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

countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
country_prevstring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
created_atstring (date-time)

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

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 (float) or null

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

search_type_newsnumber (float) or null

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

search_type_videonumber (float) or null

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

search_type_webnumber (float) 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_prevarray<string>

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

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_updatedstring (date-time) or null

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

serp_updated_prevstring (date-time) 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 (url) or null

自然搜索中排名最高的 URL(若已设置目标 URL,则显示目标 URL)。

url_prevstring (url) or null

对比日期中排名最高的 URL(若已设置目标 URL,则显示目标 URL)。

volumeinteger or null

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

volume_desktop_pctnumber (float) or null

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

volume_mobile_pctnumber (float) or null

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