경쟁사 페이지

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 매개변수에서 인식되는 식별자와 다릅니다).

selectstring필수

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

target_and_tracked_competitors_onlyboolean

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

기본:false

date_comparedstring (date)

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

datestring (date)필수

지표를 보고할 날짜(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 (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

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

traffic_value_previnteger or null

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

urlstring (url)

페이지 URL입니다.