Docs
搜索文档...⌘K

竞争对手页面

API + MCP
GET/v3/rank-tracker/competitors-pages

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

查询参数

timeoutinteger

手动超时时长(秒)。

limitinteger

要返回的结果数量。

默认:1000
order_bystring

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

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

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

selectstring必填

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

target_and_tracked_competitors_onlyboolean

将页面限制为目标网站和已跟踪的竞争对手

默认:false
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

响应

competitors-pagesarray<object>
keywordsinteger

目标关键词在前100个自然搜索结果中排名的关键词总数。

share_of_traffic_valuenumber (float)

在所有追踪关键词中,目标对象的自然搜索流量价值占总自然搜索流量价值的份额。

share_of_traffic_value_prevnumber (float)

对比日期的流量价值份额。

share_of_voicenumber (float)

在所有追踪关键词中,目标对象的自然搜索流量占总自然搜索流量的份额。

share_of_voice_prevnumber (float)

对比日期的声量份额。

statusstring

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

Allowed values:leftrightboth
titlestring or null

页面在其热门关键词的 SERP 中显示的标题。

title_prevstring or null

对比日期的标题。

trafficinteger

页面通过自然搜索获得的月访问量的估算值。

traffic_previnteger

对比日期的流量。

traffic_valueinteger or null

页面每月自然搜索流量的估算价值,以美分计。

traffic_value_previnteger or null

对比日期的流量价值。

urlstring (url)

页面 URL。