指標履歴

API + MCP

GET/v3/site-explorer/metrics-history

クエリパラメータ

selectstring

返却する列のカンマ区切りリスト。有効な列識別子については、レスポンススキーマを参照してください。

デフォルト:date,org_cost,org_traffic,paid_cost,paid_traffic

modestring

ターゲットのスコープ。

許可される値:exactprefixdomainsubdomains

デフォルト:subdomains

targetstring (url)必須

検索対象：ドメインまたはURL。

protocolstring

ターゲットのプロトコル。

許可される値:bothhttphttps

デフォルト:both

countrystring

2文字の国コード（ISO 3166-1 alpha-2）。

許可される値:adaeafagaialamaoarasatauawazba…

date_fromstring (date)必須

履歴期間の開始日（YYYY-MM-DD形式）。

date_tostring (date)

履歴期間の終了日（YYYY-MM-DD形式）。

history_groupingstring

履歴データをグループ化する際に使用する時間間隔。

許可される値:dailyweeklymonthly

デフォルト:monthly

volume_modestring

検索ボリュームの算出モード（月次または平均）。ボリューム、トラフィック、トラフィック値に影響します。

許可される値:monthlyaverage

デフォルト:monthly

traffic_modestring

オーガニックトラフィックの計算モードは、静的または適応型です。オーガニックトラフィックとトラフィック値に影響します。

許可される値:staticadaptive

デフォルト:static

outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

metricsarray<object>

datestring (date)

org_costinteger

(10単位) ターゲットの月間オーガニック検索トラフィックの推定コスト（米ドルセント）。

org_trafficinteger

(10単位) オーガニック検索からターゲットが獲得する月間推定訪問数。

paid_costinteger

(10単位) ターゲットの月間有料検索トラフィックの推定コスト（米ドルセント）。

paid_trafficinteger

(10単位) ターゲットが検索連動型広告から獲得する月間推定訪問数。