개요

API + MCP

GET/v3/rank-tracker/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

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

overviewsarray<object>

best_position_has_thumbnailboolean or null

상위 순위(또는 설정된 경우 타겟 URL)에 썸네일이 있습니다.

best_position_has_thumbnail_previousboolean or null

비교 날짜의 상위 순위(또는 설정된 경우 타겟 URL)에 썸네일이 있습니다.

best_position_has_video_previewboolean or null

상위 순위(또는 설정된 경우 타겟 URL)에 동영상 미리보기가 있습니다.

best_position_has_video_preview_previousboolean or null

비교 날짜의 상위 순위(또는 설정된 경우 타겟 URL)에 동영상 미리보기가 있습니다.

best_position_kindstring or null

상위 순위(또는 설정된 경우 타겟 URL)의 유형: 유기적, 유료 또는 SERP 기능.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

best_position_kind_previousstring or null

비교 날짜 기준의 최고 순위 유형(설정된 경우 대상 URL의 순위 유형)입니다.

clicksinteger or null

클릭 수 지표는 사용자가 목표 키워드를 검색할 때, 검색 결과를 클릭하는 월평균 횟수를 의미합니다. 검색자가 결과를 클릭하지 않는 경우도 있고 여러 번 클릭할 수도 있기 때문에 검색 수와는 차이가 있을 수 있습니다.

clicks_per_searchnumber (float) or null

검색당 클릭 수는 키워드 검색량 대비 클릭 비율을 나타냅니다. 특정 국가에서 해당 키워드 검색 시 사용자가 평균적으로 몇 개의 검색결과를 클릭하는지 보여줍니다.

cost_per_clickinteger or null

클릭당 비용은 키워드에 대한 유료 검색 결과에서 광고주가 각 광고 클릭에 지불하는 평균 가격을 보여줍니다.

countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

country_prevstring

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

created_atstring (date-time)

프로젝트에 키워드가 추가된 날짜입니다.

is_brandedboolean

사용자 의도: 브랜드형. 사용자가 특정 브랜드나 회사 이름을 검색하는 경우입니다.

is_commercialboolean

사용자 의도: 상업형. 사용자가 구매 결정을 내리기 전에 제품이나 서비스를 비교·검토하는 검색 의도입니다.

is_informationalboolean

사용자 의도: 정보형. 사용자가 특정 질문에 대한 답이나 정보를 찾고자 합니다.

is_localboolean

사용자 의도: 지역형. 사용자가 특정 위치 또는 인근 서비스와 관련된 정보를 찾고자 합니다.

is_navigationalboolean

사용자 의도: 탐색형. 사용자가 특정 웹사이트나 웹페이지를 찾기 위해 검색합니다.

is_transactionalboolean

사용자 의도: 거래형. 사용자가 구매와 같은 특정 행동을 완료할 준비가 된 상태입니다.

keywordstring

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

keyword_difficultyinteger or null

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

keyword_has_databoolean

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

keyword_is_frozenboolean

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

keyword_prevstring

비교 날짜에 타겟이 순위에 오른 키워드입니다.

languagestring

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

language_prevstring

비교 날짜의 SERP 언어입니다.

locationstring

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

location_prevstring

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

parent_topicstring or null

상위 주제는 페이지에서 보다 일반적인 주제를 타겟으로 하는 동안 목표 키워드로 1위 랭크할 수 있는지를 결정합니다. 상위 주제를 파악하기 위해 키워드에 대한 1위 페이지를 찾아 가장 많은 트래픽을 유도하는 키워드를 찾습니다.

positioninteger or null

유기적 검색에서의 최고 순위(설정된 경우 대상 URL의 순위)입니다.

position_diffinteger or null

선택한 날짜 사이의 최고 순위(설정된 경우 대상 URL의 순위) 변화입니다.

position_previnteger or null

비교 날짜 기준의 최고 순위(설정된 경우 대상 URL의 순위)입니다.

search_type_imagenumber (float) or null

검색 유형 이미지는 키워드에 대해 이미지가 검색된 비율을 보여주며, 비주얼 콘텐츠에 대한 관심을 강조합니다.

search_type_newsnumber (float) or null

검색 유형 "뉴스"는 해당 키워드가 뉴스 검색에서 차지하는 비율을 나타냅니다.

search_type_videonumber (float) or null

검색 유형 비디오는 비디오 콘텐츠에 대한 관심을 반영하여 비디오를 위해 이루어진 키워드 검색의 비율을 보여줍니다.

search_type_webnumber (float) or null

웹 검색 유형은 특정 키워드에 대해 일반 웹 검색에서 발생한 검색 비율을 나타냅니다. 이는 해당 키워드가 가진 일반적인 관심도의 지표입니다.

serp_featuresarray<string>

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

serp_features_prevarray<string>

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

serp_updatedstring (date-time) or null

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

serp_updated_prevstring (date-time) or null

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

tagsarray<string>

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

tags_prevarray<string>

비교 날짜에 해당 키워드에 할당된 태그 목록입니다.

target_positions_countinteger

키워드에서 순위에 오른 타겟 URL 수입니다.

trafficinteger or null

"volume_mode" 매개변수에 따라 최근 1개월 또는 확인 가능한 최근 12개월 데이터 기준으로, 페이지가 자연 검색에서 얻는 월간 방문 수를 추정한 값입니다.

traffic_diffinteger or null

선택한 날짜 사이의 트래픽 변화입니다.

traffic_previnteger or null

"volume_mode" 매개변수에 따라 최근 1개월 또는 확인 가능한 최근 12개월 데이터 기준으로, 페이지가 자연 검색에서 얻는 월간 방문 수를 추정한 값입니다.

urlstring (url) or null

자연 검색에서 가장 상위에 노출되는 URL(또는 설정된 경우 타깃 URL)입니다.

url_prevstring (url) or null

비교 날짜에 가장 상위에 노출되는 URL(또는 설정된 경우 타깃 URL)입니다.

volumeinteger or null

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

volume_desktop_pctnumber (float) or null

전체 검색량 중 데스크톱 기기에서 발생한 검색량의 비율입니다.

volume_mobile_pctnumber (float) or null

전체 검색량 중 모바일 기기에서 발생한 검색량의 비율입니다.