SERP 개요

API + MCP

GET/v3/rank-tracker/serp-overview

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

쿼리 매개변수

top_positionsinteger

반환할 유기적 SERP 상위 순위 개수입니다. 지정하지 않으면 사용 가능한 모든 순위를 반환합니다.

devicestring필수

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

허용되는 값:desktopmobile

datestring

YYYY-MM-DDThh:mm:ss 형식으로, 마지막으로 사용 가능한 SERP 개요를 반환할 타임스탬프입니다. 지정하지 않으면 가장 최신 SERP 개요가 반환됩니다.

location_idinteger

추적 중인 키워드의 위치 ID입니다. 추적 중인 키워드의 국가 코드, 언어 코드 및 위치 ID를 얻으려면 management/project-keywords 엔드포인트를 사용할 수 있습니다.

countrystring필수

2자리 국가 코드(ISO 3166-1 alpha-2)입니다.

허용되는 값:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

language_codestring

추적 중인 키워드의 언어 코드입니다. 추적 중인 키워드의 국가 코드, 언어 코드 및 위치 ID를 얻으려면 management/project-keywords 엔드포인트를 사용할 수 있습니다.

keywordstring필수

SERP 개요를 반환할 키워드입니다.

project_idinteger필수

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

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

positionsarray<object>

ahrefs_rankinteger or null

당사 데이터베이스에 있는 다른 웹사이트와 비교한 도메인의 백링크 프로필 강도를 나타냅니다. 1위가 가장 강력한 백링크 프로필을 가진 웹사이트입니다.

backlinksinteger or null

검색 결과를 가리키는 다른 웹사이트로부터의 총 링크 수입니다.

domain_ratingnumber or null

당사 데이터베이스의 다른 도메인과 비교한 도메인의 백링크 프로필 강도를 100점 척도로 나타낸 값입니다.

keywordsinteger or null

검색 결과가 상위 100위 자연 순위에 오른 키워드의 총 개수입니다.

nr_wordsinteger or null

웹페이지 HTML에 포함된 총 단어 수입니다.

page_typestring or null

순위 페이지에 대해 AI가 예측한 계층형 페이지 유형 경로 목록(쉼표로 구분)입니다. 각 값은 슬래시(/)로 시작하는 경로입니다(예: /Article/How_to).

positioninteger

SERP에서 검색 결과의 순위입니다.

refdomainsinteger or null

검색 결과에 링크를 제공하는 고유 도메인의 총 수입니다.

titlestring or null

순위에 오른 페이지의 제목입니다.

top_keywordstring or null

검색 결과에 가장 많은 자연 검색 트래픽을 유입시키는 키워드입니다.

top_keyword_volumeinteger or null

최근 12개월간의 데이터를 기준으로 상위 키워드의 월평균 검색 횟수를 추정한 값을 보여줍니다.

trafficinteger or null

해당 결과가 순위에 오른 모든 키워드에서 얻는 월간 자연 검색 트래픽의 추정치입니다.

typearray<string>

포지션의 유형: 자연 검색, 유료, 또는 SERP 기능. 허용되는 값: ai_overview, ai_overview_sitelink, discussion, image, image_th, knowledge_card, knowledge_panel, local_pack, organic, organic_shopping, paid_top, paid_bottom, paid_right, question, sitelink, snippet, top_story, tweet, video, video_th.

update_datestring

키워드에 대한 검색 엔진 결과를 확인한 날짜입니다.

urlstring or null

순위에 오른 페이지의 URL입니다.

url_ratingnumber or null

페이지의 백링크 프로필 강도를 100점 로그 척도로 나타낸 값입니다.

valueinteger or null

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