Docs
搜索文档...⌘K

竞争对手概述

API + MCP
GET/v3/rank-tracker/competitors-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

输出格式。

允许的值:jsonphp

响应

keywordsarray<object>
competitors_listarray<object>

指定关键词的竞争对手信息。包含以下字段:urlurl_prevpositionposition_prevbest_position_kindbest_position_kind_prevtraffictraffic_prevvaluevalue_prev。以 prev 结尾的字段仅在对比视图中返回。

countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
keywordstring

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

keyword_difficultyinteger or null

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

keyword_has_databoolean

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

keyword_is_frozenboolean

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

languagestring

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

locationstring

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

serp_featuresarray<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>

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

volumeinteger or null

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