상위 페이지

API + MCP

GET/v3/site-explorer/top-pages

쿼리 매개변수

timeoutinteger

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

limitinteger

반환할 결과 수입니다.

기본:1000

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

필터 표현식입니다. 다음 열 식별자가 인식됩니다(이는 select 파라미터에서 인식되는 식별자와 다릅니다).

cpc
type: integer nullable

cpc_prev: 비교 날짜의 CPC 지표입니다.
type: integer nullable

has_thumbnail: 해당 순위에 썸네일이 있습니다.
type: boolean

has_thumbnail_prev: 비교 날짜의 순위에 썸네일이 있습니다.
type: boolean

has_video: 해당 순위에 동영상이 있습니다.
type: boolean

has_video_prev: 비교 날짜의 순위에 동영상이 있습니다.
type: boolean

keyword: 대상이 랭크되는 키워드입니다.
type: string

keyword_difficulty (10 units): 키워드에 대해 자연 검색 상위 10위에 랭크되기 얼마나 어려운지의 추정치(100점 척도)입니다.
type: integer nullable

keyword_difficulty_prev (10 units): 비교 날짜의 키워드 난이도입니다.
type: integer nullable

keyword_prev: 비교 날짜에 대상이 랭크되던 키워드입니다.
type: string

keywords: 대상이 자연 검색 상위 100위 내에서 랭크되는 총 키워드 수입니다.
type: integer

keywords_diff: 선택한 날짜 간 키워드 수 변화입니다.
type: integer

keywords_diff_percent: 선택한 날짜 간 키워드 수 변화(퍼센트)입니다.
type: integer

keywords_merged: 정렬에 최적화된 총 키워드 수입니다.
type: integer

keywords_prev: 비교 날짜에 대상이 랭크되던 키워드 수입니다.
type: integer

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

position: 키워드에 대한 자연 검색 결과에서 대상의 순위입니다.
type: integer

position_kind: 순위의 유형입니다(자연 검색, 유료 또는 SERP 기능). 이는 최고 순위를 선택하기 전, 특정 키워드와 URL에 대한 모든 순위에 적용됩니다.
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

position_kind_prev: 비교 날짜의 순위 유형입니다.
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

position_prev: 비교 날짜의 해당 키워드에 대한 대상 순위입니다.
type: integer

raw_url: 인코딩된 형식의 랭킹 페이지 URL입니다.
type: string

raw_url_prev: 비교 날짜의 인코딩된 형식 랭킹 페이지 URL입니다.
type: string

referring_domains (5 units): 페이지로 링크되는 고유 도메인 수입니다.
type: integer nullable

serp_features
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_features_prev: 비교 날짜의 SERP 기능입니다.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

status: 페이지 상태입니다. 새로 랭크되기 시작한 페이지("left"), 검색 결과에서 사라진 페이지("right"), 또는 변화 없음("both").
type: string
enum: "left" "right" "both"

sum_traffic (10 units): 페이지가 랭크되는 모든 키워드에서 발생하는 추정 월간 자연 검색 트래픽입니다.
type: integer nullable

sum_traffic_merged (10 units): 정렬에 최적화된 트래픽 필드입니다.
type: integer

sum_traffic_prev (10 units): 비교 날짜의 트래픽입니다.
type: integer nullable

top_keyword: 페이지에 가장 많은 자연 검색 트래픽을 가져오는 키워드입니다.
type: string nullable

top_keyword_best_position: 상위 키워드에서 페이지가 차지하는 랭킹 순위입니다.
type: integer nullable

top_keyword_best_position_diff: 선택한 날짜 간 최고 순위 변화입니다.
type: integer nullable

top_keyword_best_position_kind: 최고 순위의 유형입니다(자연 검색, 유료 또는 SERP 기능).
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

top_keyword_best_position_kind_prev: 비교 날짜의 최고 순위 유형입니다.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

top_keyword_best_position_prev: 비교 날짜의 최고 순위입니다.
type: integer nullable

top_keyword_best_position_title: 상위 키워드의 SERP에서 해당 페이지에 표시되는 제목입니다.
type: string nullable

top_keyword_best_position_title_prev: 비교 날짜의 상위 키워드 SERP에서 해당 페이지에 표시된 제목입니다.
type: string nullable

top_keyword_country: 페이지가 상위 키워드로 랭크되는 국가입니다.
type: string nullable
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

top_keyword_country_prev: 비교 날짜에 페이지가 상위 키워드로 랭크되던 국가입니다.
type: string nullable
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

top_keyword_prev: 비교 날짜에 페이지에 가장 많은 자연 검색 트래픽을 가져오던 키워드입니다.
type: string nullable

top_keyword_volume (10 units): "volume_mode" 파라미터에 따라 최근 한 달 또는 최근 확인된 12개월 데이터 기준으로, 상위 키워드의 추정 평균 월간 검색량입니다.
type: integer nullable

top_keyword_volume_prev (10 units): 비교 날짜의 검색량입니다.
type: integer nullable

traffic (10 units): 키워드에서 발생하는 대상의 추정 월간 자연 검색 트래픽입니다.
type: integer

traffic_diff: 선택한 날짜 간 트래픽 변화입니다.
type: integer

traffic_diff_percent: 선택한 날짜 간 트래픽 변화(퍼센트)입니다.
type: integer

traffic_prev (10 units): 비교 날짜의 키워드 트래픽입니다.
type: integer

ur: URL 등급(UR)은 대상 페이지의 백링크 프로필 강도를 100점 로그 스케일로 보여줍니다.
type: float nullable

url: 랭킹 페이지 URL입니다.
type: url nullable

url_prev: 비교 날짜의 랭킹 페이지 URL입니다.
type: url nullable

value (10 units): 페이지의 추정 월간 자연 검색 트래픽 가치이며, USD 센트 단위입니다.
type: integer nullable

value_diff: 선택한 날짜 간 트래픽 가치 변화입니다.
type: integer

value_diff_percent: 선택한 날짜 간 트래픽 가치 변화(퍼센트)입니다.
type: integer

value_merged (10 units): 정렬에 최적화된 트래픽 가치 필드입니다.
type: integer nullable

value_prev (10 units): 비교 날짜의 트래픽 가치입니다.
type: integer nullable

volume (10 units): 최근 한 달간 키워드의 추정 검색량입니다.
type: integer nullable

volume_prev (10 units): 비교 날짜의 검색량입니다.
type: integer nullable

words: 키워드의 단어 수입니다.
type: integer

words_prev: 비교 날짜의 키워드 단어 수입니다.
type: integer

selectstring필수

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

protocolstring

대상의 프로토콜입니다.

허용되는 값:bothhttphttps

기본:both

targetstring필수

검색 대상: 도메인 또는 URL.

modestring

입력한 대상에 따라 검색 범위를 지정합니다.

허용되는 값:exactprefixdomainsubdomains

기본:subdomains

countrystring

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

허용되는 값:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

date_comparedstring

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

datestring필수

지표를 보고할 날짜(YYYY-MM-DD 형식).

volume_modestring

검색량 계산 모드: monthly 또는 average. 검색량, 트래픽 및 트래픽 가치에 영향을 줍니다.

허용되는 값:monthlyaverage

기본:monthly

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

pagesarray<object>

keywordsinteger or null

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

keywords_diffinteger

선택한 날짜 간의 키워드 변화입니다.

keywords_diff_percentinteger

선택한 날짜 사이의 키워드 변화율(%)입니다.

keywords_mergedinteger

정렬에 최적화된 키워드의 총 개수입니다.

keywords_previnteger or null

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

page_typestring or null

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

raw_urlstring

순위 페이지 URL을 인코딩된 형식으로 나타낸 값입니다.

raw_url_prevstring or null

비교 날짜의 순위 페이지 URL을 인코딩된 형식으로 나타낸 값입니다.

referring_domainsinteger or null

(5단위) 페이지에 링크를 건 고유 도메인 수입니다.

statusstring

페이지 상태: 순위를 막 얻기 시작한 새 페이지("left"), 검색 결과에서 사라진 페이지("right"), 또는 변화 없음("both")입니다.

Allowed values:leftrightboth

sum_trafficinteger or null

(10단위) 페이지가 순위를 차지하는 모든 키워드로부터 얻는 월간 유기적 검색 트래픽 추정치입니다.

sum_traffic_mergedinteger

(10 units) 정렬에 최적화된 트래픽 필드입니다.

sum_traffic_previnteger or null

(10 units) 비교 날짜의 트래픽입니다.

top_keywordstring or null

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

top_keyword_best_positioninteger or null

페이지가 해당 키워드에서 차지하는 순위 위치를 나타냅니다.

top_keyword_best_position_diffinteger or null

선택한 날짜 사이의 최상위 순위 변화입니다.

top_keyword_best_position_kindstring or null

최상위 순위의 유형: 유기적, 유료 또는 SERP 기능입니다.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

top_keyword_best_position_kind_prevstring or null

비교 날짜의 최고 순위 유형입니다.

top_keyword_best_position_previnteger or null

비교 날짜의 최고 순위입니다.

top_keyword_best_position_titlestring or null

페이지의 상위 키워드 SERP에 표시되는 제목입니다.

top_keyword_best_position_title_prevstring or null

비교 날짜에 페이지의 상위 키워드 SERP에 표시되는 제목입니다.

top_keyword_countrystring or null

페이지가 상위 키워드에서 순위를 차지하는 국가입니다.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

top_keyword_country_prevstring or null

비교 날짜에 페이지가 상위 키워드에서 순위를 차지하는 국가입니다.

top_keyword_prevstring or null

비교 날짜 기준으로 페이지에 가장 많은 자연 검색 트래픽을 유입시키는 키워드입니다.

top_keyword_volumeinteger or null

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

top_keyword_volume_previnteger or null

(10 units) 비교 날짜의 검색량입니다.

traffic_diffinteger

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

traffic_diff_percentinteger

선택한 날짜 사이의 트래픽 변화를 백분율(%)로 나타낸 값입니다.

urnumber or null

URL 등급(UR)은 목표 페이지의 백링크 프로필 강도를 100점 로그 척도로 나타냅니다.

urlstring or null

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

url_prevstring or null

비교 날짜 기준으로 순위에 오른 페이지의 URL입니다.

valueinteger or null

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

value_diffinteger

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

value_diff_percentinteger

선택한 날짜 사이의 트래픽 가치 변화를 백분율(%)로 나타낸 값입니다.

value_mergedinteger or null

(10 units) 정렬에 최적화된 트래픽 가치 필드입니다.

value_previnteger or null

(10 units) 비교 날짜의 트래픽 가치입니다.