順位別 CTR

API + MCP

GET/v3/gsc/ctr-by-position

このエンドポイントへのリクエストは無料で、APIユニットを消費しません。

クエリパラメータ

project_idinteger

プロジェクトID。portfolio_id が指定されていない場合は必須です。

portfolio_idinteger

ポートフォリオID。指定すると、ポートフォリオ内のGSCに接続されているすべてのプロジェクトのデータを集計します。

date_fromstring (date)必須

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

date_tostring (date)

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

countrystring

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

許可される値:adaeafagaialamaoarasatauawazba…

devicestring

デバイスの種類（DESKTOP、MOBILE、TABLET）でフィルタリングします。指定しない場合は、すべてのデバイスが対象になります。

許可される値:desktopmobiletablet

outputstring

出力形式。

許可される値:jsoncsvxmlphp

metricsarray<object>

average_ctr_percentnumber (float)

keyword_countinteger

positioninteger