総検索ボリュームの推移

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 units) 検索結果で指定した top_positions 以内にターゲットがランクインしているキーワードの合計検索ボリュームです。