상위 페이지

API + MCP

GET/v3/site-explorer/top-pages

쿼리 매개변수

timeoutinteger

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

limitinteger

반환할 결과 수입니다.

기본:1000

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

selectstring필수

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

protocolstring

대상의 프로토콜입니다.

허용되는 값:bothhttphttps

기본:both

targetstring (url)필수

검색 대상은 도메인 또는 URL입니다.

modestring

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

허용되는 값:exactprefixdomainsubdomains

기본:subdomains

countrystring

두 글자로 된 국가 코드(ISO 3166-1 alpha-2)입니다.

허용되는 값:adaeafagaialamaoarasatauawazba…

date_comparedstring (date)

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

datestring (date)필수

메트릭을 보고할 날짜로, YYYY-MM-DD 형식입니다.

traffic_modestring

자연 검색 트래픽 계산 방식: 정적 또는 적응형. 자연 검색 트래픽과 트래픽 가치에 영향을 줍니다.

허용되는 값:staticadaptive

기본:static

volume_modestring

검색량 계산 모드(월별 또는 평균)입니다. 이 모드는 검색량, 트래픽, 트래픽 가치에 영향을 미칩니다.

허용되는 값:monthlyaverage

기본:monthly

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

pagesarray<object>

ai_responses_chatgptinteger or null

(10 units) 선택한 국가(또는 모든 국가 합산)에서 해당 페이지가 포함된 ChatGPT 응답 수입니다. 여기에는 페이지가 출처로 인용된 경우뿐만 아니라 백그라운드에서만 불러온 경우도 포함됩니다. 브랜드 레이더에서 제공되며, 해당 인덱스가 필요합니다.

ai_responses_copilotinteger or null

(10 units) 선택한 국가(또는 모든 국가 합산)에서 해당 페이지가 포함된 Microsoft Copilot 응답 수입니다. 여기에는 페이지가 출처로 인용된 경우뿐만 아니라 백그라운드에서만 불러온 경우도 포함됩니다. 브랜드 레이더에서 제공되며, 해당 인덱스가 필요합니다.

ai_responses_geminiinteger or null

(10개 단위) 선택한 국가에서(또는 모든 국가를 합산하여) 해당 페이지가 표시된 Gemini 응답 수입니다. 여기에는 페이지가 출처로 인용된 경우와 백그라운드에서만 조회된 경우가 모두 포함됩니다. 브랜드 레이더에서 제공하며, 해당 인덱스가 필요합니다.

ai_responses_google_ai_modeinteger or null

(10개 단위) 선택한 국가에서(또는 모든 국가를 합산하여) 해당 페이지가 표시된 Google AI Mode 응답 수입니다. 여기에는 페이지가 출처로 인용된 경우와 백그라운드에서만 조회된 경우가 모두 포함됩니다. 브랜드 레이더에서 제공하며, 해당 인덱스가 필요합니다.

ai_responses_google_ai_overviewsinteger or null

(10개 단위) 선택한 국가에서(또는 모든 국가를 합산하여) 해당 페이지가 표시된 Google AI 개요 응답 수입니다. 여기에는 페이지가 출처로 인용된 경우와 백그라운드에서만 조회된 경우가 모두 포함됩니다. 브랜드 레이더에서 제공하며, 해당 인덱스가 필요합니다.

ai_responses_grokinteger or null

(10개 단위) 선택한 국가에서(또는 모든 국가를 합산하여) 해당 페이지가 표시된 Grok 응답 수입니다. 여기에는 페이지가 출처로 인용된 경우와 백그라운드에서만 조회된 경우가 모두 포함됩니다. 브랜드 레이더에서 제공하며, 해당 인덱스가 필요합니다.

ai_responses_perplexityinteger or null

(10개 단위) 선택한 국가에서(또는 모든 국가를 합산하여) 해당 페이지가 표시된 Perplexity 응답 수입니다. 여기에는 페이지가 출처로 인용된 경우와 백그라운드에서만 조회된 경우가 모두 포함됩니다. 브랜드 레이더에서 제공하며, 해당 인덱스가 필요합니다.

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")입니다.

허용되는 값: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 기능입니다.

허용되는 값:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

top_keyword_best_position_kind_prevstring or null

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

허용되는 값:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

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

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

허용되는 값:ADAEAFAGAIALAMAOAQARASATAUAWAX…

top_keyword_country_prevstring or null

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

허용되는 값:ADAEAFAGAIALAMAOAQARASATAUAWAX…

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 (float) or null

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

urlstring (url) or null

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

url_prevstring (url) 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) 비교 날짜의 트래픽 가치입니다.