총 검색량 추이

API + MCP

GET/v3/site-explorer/total-search-volume-history

쿼리 매개변수

modestring

대상의 범위입니다.

허용되는 값:exactprefixdomainsubdomains

기본:subdomains

targetstring (url)필수

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

portfolio_idinteger

포트폴리오의 고유 식별자입니다. 제공되면 target보다 우선합니다.

protocolstring

대상의 프로토콜입니다.

허용되는 값:bothhttphttps

기본:both

countrystring

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

허용되는 값:adaeafagaialamaoarasatauawazba…

date_fromstring (date)필수

YYYY-MM-DD 형식의 과거 기간 시작일입니다.

date_tostring (date)

YYYY-MM-DD 형식의 과거 기간 종료일입니다.

history_groupingstring

이력 데이터를 그룹화하는 데 사용할 시간 간격입니다.

허용되는 값:dailyweeklymonthly

기본:monthly

top_positionsstring

전체 검색량을 계산할 때 고려할 상위 자연 검색 순위의 개수입니다.

허용되는 값:top_10top_100

기본:top_10

volume_modestring

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

허용되는 값:monthlyaverage

기본:monthly

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

metricsarray<object>

datestring (date)

total_search_volumeinteger

(10 단위) 검색 결과에서 지정된 top_positions 내에 타겟이 순위에 오른 키워드의 총 검색량입니다.