竞争对手页面
API + MCPGET/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。
errorstring
errorstring
errorstring
errorstring
errorstring