경쟁사 개요

API + MCP

GET/v3/rank-tracker/competitors-overview

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

쿼리 매개변수

timeoutinteger

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

limitinteger

반환할 결과 수입니다.

기본:1000

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

필터 표현식입니다. 다음 열 식별자를 인식합니다(이는 select 매개변수가 인식하는 식별자와 다릅니다).

selectstring필수

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

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

출력 형식입니다.

허용되는 값:jsonphp

응답

keywordsarray<object>

competitors_listarray<object>

해당 키워드의 경쟁사 정보입니다. 다음 필드가 포함됩니다: url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. prev로 끝나는 필드는 비교 보기에서만 포함됩니다.

countrystring

지정된 키워드가 추적되고 있는 국가입니다. 두 글자 국가 코드(ISO 3166-1 alpha-2)입니다.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

keywordstring

타겟이 순위에 오른 키워드입니다.

keyword_difficultyinteger or null

키워드 난이도는 특정 키워드로 유기적 검색 결과 상위 10위 안에 들기 얼마나 어려운지를 100점 척도로 추정한 값입니다.

keyword_has_databoolean

키워드가 아직 처리 중이며 SERP를 아직 가져오지 않았다면 false를 반환합니다.

keyword_is_frozenboolean

키워드가 요금제의 추적 키워드 한도를 초과했는지 여부를 나타냅니다. 이러한 키워드는 "동결"되어 순위가 업데이트되지 않습니다.

languagestring

지정된 키워드를 추적하는 SERP 언어입니다.

locationstring

지정된 키워드가 추적되고 있는 특정 위치(국가, 주/도, 또는 도시)입니다.

serp_featuresarray<string>

키워드의 검색 결과에 표시되는 SERP 기능입니다.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

serp_updatedstring (date-time) or null

해당 키워드에 대해 마지막으로 검색 엔진 결과를 확인한 날짜입니다.

serp_updated_prevstring (date-time) or null

비교 날짜까지의 검색 엔진 결과를 확인한 날짜입니다.

tagsarray<string>

특정 키워드에 할당된 태그 목록입니다.

volumeinteger or null

"volume_mode" 매개변수에 따라 최근 1개월 또는 확인 가능한 최근 12개월 데이터 기준으로 키워드의 월평균 검색 횟수를 추정한 값입니다.