Docs
문서 검색...⌘K

경쟁사 페이지

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

이 엔드포인트로의 요청은 무료이며 API 유닛을 소모하지 않습니다.

쿼리 매개변수

timeoutinteger

수동 타임아웃 시간(초)입니다.

limitinteger

반환할 결과 수입니다.

기본:1000
order_bystring

선택적으로 정렬 방향을 지정할 수 있는, 결과 정렬에 사용할 열의 쉼표로 구분된 목록입니다. 유효한 열 식별자는 응답 스키마를 참고하세요.

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필수

반환할 열 목록(쉼표로 구분)입니다. 유효한 열 식별자는 응답 스키마를 참고하세요.

target_and_tracked_competitors_onlyboolean

페이지를 타겟 및 추적 중인 경쟁사로 제한합니다.

기본:false
date_comparedstring

YYYY-MM-DD 형식으로 비교할 날짜입니다.

datestring필수

지표를 보고할 날짜(YYYY-MM-DD 형식).

devicestring필수

모바일 순위와 데스크톱 순위 중에서 선택합니다.

허용되는 값:desktopmobile
project_idinteger필수

프로젝트의 고유 식별자입니다. Ahrefs에서 순위 트래커 프로젝트의 URL에서 확인할 수 있습니다: https://app.ahrefs.com/rank-tracker/overview/#project_id#

volume_modestring

검색량 계산 모드: monthly 또는 average. 검색량, 트래픽 및 트래픽 가치에 영향을 줍니다.

허용되는 값: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

페이지의 월간 자연 검색 트래픽의 추정 가치이며, 단위는 USD 센트입니다.

traffic_value_previnteger or null

비교 날짜의 트래픽 가치입니다.

urlstring

페이지 URL입니다.