キーワード
API + MCPGET/v3/gsc/keywords
このエンドポイントへのリクエストは無料で、APIユニットを消費しません。
クエリパラメータ
project_idinteger
プロジェクトID。portfolio_id が指定されていない場合は必須です。
portfolio_idinteger
ポートフォリオID。指定すると、ポートフォリオ内のGSCに接続されているすべてのプロジェクトのデータを集計します。
date_fromstring (date)必須
履歴期間の開始日（YYYY-MM-DD形式）。
date_tostring (date)
履歴期間の終了日（YYYY-MM-DD形式）。
search_typestring
返される検索結果の種類（web、image、video、news）。
許可される値:webimagevideonews
デフォルト:web
countrystring
2文字の国コード（ISO 3166-1 alpha-2）。
許可される値:adaeafagaialamaoarasatauawazba…
devicestring
デバイスの種類（DESKTOP、MOBILE、TABLET）でフィルタリングします。指定しない場合は、すべてのデバイスが対象になります。
許可される値:desktopmobiletablet
limitinteger
返す結果数です。
デフォルト:1000
wherestring
サポートされているフィールド：
keyword_list_idinteger
メトリクスを表示する既存のキーワードリストのID。
keyword_listsstring
キーワードリスト用のフィルタ（JSON文字列）。include（is）、exclude（is_not）、empty（どのリストにも含まれない）、not_empty（いずれかのリストに含まれる）をサポートします。
outputstring
出力形式。
許可される値:jsonphpxml
応答
keywordsarray<object>
clicksinteger or null
ctrnumber (float) or null
impressionsinteger or null
keywordstring
keyword_list_labelsarray<string>
positionnumber (float) or null
平均掲載順位（小数、例：4.7）
top_urlstring (url) or null
urls_countinteger
errorstring
errorstring
errorstring
errorstring
errorstring