총 검색량 추이

API + MCP

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

쿼리 매개변수

volume_modestring

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

허용되는 값:monthlyaverage

기본:monthly

top_positionsstring

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

허용되는 값:top_10top_100

기본:top_10

history_groupingstring

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

허용되는 값:dailyweeklymonthly

기본:monthly

date_tostring

YYYY-MM-DD 형식의 이력 기간 종료일.

date_fromstring필수

YYYY-MM-DD 형식의 이력 기간 시작일.

countrystring

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

허용되는 값:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

protocolstring

대상의 프로토콜입니다.

허용되는 값:bothhttphttps

기본:both

targetstring필수

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

modestring

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

허용되는 값:exactprefixdomainsubdomains

기본:subdomains

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

metricsarray<object>

datestring

total_search_volumeinteger

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