竞争对手页面

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

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"

domain：页面域名。 type: string

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

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

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

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

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

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

url：页面 URL。 type: string

selectstring必填

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

target_and_tracked_competitors_onlyboolean

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

默认:false

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

响应

competitors-pagesarray<object>

keywordsinteger

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

share_of_traffic_valuenumber

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

share_of_traffic_value_prevnumber

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

share_of_voicenumber

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

share_of_voice_prevnumber

对比日期的声量份额。

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。