SERP 개요

API + MCP

GET/v3/serp-overview/serp-overview

쿼리 매개변수

selectstring필수

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

top_positionsinteger

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

datestring

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

countrystring필수

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

허용되는 값:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

keywordstring필수

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

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

positionsarray<object>

ahrefs_rankinteger or null

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

backlinksinteger or null

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

domain_ratingnumber or null

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

keywordsinteger or null

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

page_typestring or null

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

positioninteger

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

refdomainsinteger or null

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

titlestring or null

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

top_keywordstring or null

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

top_keyword_volumeinteger or null

(10 units) 최근 알려진 12개월 데이터를 기준으로 상위 키워드의 월평균 검색 횟수를 추정한 값입니다.

trafficinteger or null

(10 units) 결과가 순위에 오른 모든 키워드에서 얻는 월간 자연 검색 트래픽을 추정한 값입니다.

typearray<string>

포지션 유형: 자연 검색, 유료, 또는 SERP 기능.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

update_datestring

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

urlstring or null

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

url_ratingnumber or null

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

valueinteger or null

(10 units) USD 센트 기준 페이지의 월간 자연 검색 트래픽 추정 가치입니다.