GSC APIで検索クエリを取得する方法【初心者でもコピペで動いた最小コード】

結論｜GSC APIでクエリを取得する仕組みと使い道

GSC APIでクエリ一覧を取得するには、searchanalytics.query メソッドに dimensions: ['query'] を指定するだけです。コマンド1つでどんなキーワードで検索されているかを自動取得できます。

すぐ試したい場合は、以下のパターン1のコードをそのまま実行してください。事前準備（GCPとサービスアカウント）についてはSearch Console APIでCSV出力する方法【初心者でもコピペで動いた最小コード】をご覧ください。

なお、この記事はCSV出力記事の「中身（データ取得）」を解説する続編です。CSV出力の仕組みはすでに動いている前提で、検索クエリの取得方法に特化した内容を解説します。

この記事は以下に当てはまる方向けです。

• GSC APIは設定できたが、クエリ一覧の取得方法がわからない
• どのキーワードでサイトに流入しているか知りたい
• dimensionsの指定方法が知りたい
• 特定のページへの流入クエリだけを絞り込みたい
• 取得したクエリをSEO改善に使いたい

CSV出力記事との違い

前回のCSV出力記事では dimensions: ['query', 'page'] でクエリとページの両方を取得しました。今回は検索クエリに特化した取得と、ページでフィルタリングする方法に絞って解説します。特定の記事にどんなキーワードで流入しているかを調べるときに使えます。

APIリクエストの基本｜dimensionsの仕組み

GSC APIの searchanalytics.query では、何の軸でデータを取得するかを dimensions で指定します。ここが理解できると、クエリ以外のデータも自由に取れるようになりますよね。

dimensionsに指定できる値

| 値 | 取得できるもの |

|---|---|

| query | 検索クエリ（キーワード） |

| page | 流入したページURL |

| date | 日付 |

| device | デバイス種別（desktop/mobile/tablet） |

| country | 国 |

複数を配列で指定すると組み合わせ軸で取得できます。['query', 'page'] にすると「この検索クエリはどのページに流入したか」がわかります。

クエリ取得の基本リクエスト構造

const res = await searchConsole.searchanalytics.query({
  siteUrl: SITE_URL,
  requestBody: {
    startDate: '2026-01-01',
    endDate:   '2026-04-01',
    dimensions: ['query'],  // クエリのみ
    rowLimit: 1000,
  },
})

res.data.rows に結果が入ります。各rowには keys（クエリ名）・clicks・impressions・ctr・position が含まれます。

フィルターの使い方

特定のページへの流入クエリだけを取りたい場合は dimensionFilterGroups を使います。

requestBody: {
  startDate: '2026-01-01',
  endDate:   '2026-04-01',
  dimensions: ['query'],
  dimensionFilterGroups: [{
    filters: [{
      dimension: 'page',
      operator: 'contains',
      expression: '/chunkloaderror-cache-not-fixed'
    }]
  }],
  rowLimit: 1000,
}

これで特定の記事URLへの流入クエリだけが取れます。

最小コードでクエリ一覧を取得する

3パターンのコードを公開します。状況に応じて使い分けてください。すぐ試したい方はパターン1から実行できます。

パターン1：全検索クエリを取得する（最小構成）

import { google } from 'googleapis'

const KEY_FILE = '/path/to/gsc_key.json'
const SITE_URL = 'sc-domain:example.com'

const auth = new google.auth.GoogleAuth({
  keyFile: KEY_FILE,
  scopes: ['https://www.googleapis.com/auth/webmasters.readonly'],
})

const sc = google.searchconsole({ version: 'v1', auth })

const res = await sc.searchanalytics.query({
  siteUrl: SITE_URL,
  requestBody: {
    startDate: '2026-01-01',
    endDate:   '2026-04-01',
    dimensions: ['query'],
    rowLimit: 1000,
  },
})

const rows = res.data.rows ?? []
rows.forEach(row => {
  console.log(`${row.keys[0]} | クリック:${row.clicks} | 順位:${row.position.toFixed(1)}`)
})

パターン2：特定ページの流入クエリを取得する

const res = await sc.searchanalytics.query({
  siteUrl: SITE_URL,
  requestBody: {
    startDate: '2026-01-01',
    endDate:   '2026-04-01',
    dimensions: ['query'],
    dimensionFilterGroups: [{
      filters: [{
        dimension: 'page',
        operator: 'contains',
        expression: '/your-slug'
      }]
    }],
    rowLimit: 1000,
  },
})

expression に調べたい記事のslugを入れてください。

パターン3：クエリとページを両軸で取得する（CSV出力記事と同じ）

const res = await sc.searchanalytics.query({
  siteUrl: SITE_URL,
  requestBody: {
    startDate: '2026-01-01',
    endDate:   '2026-04-01',
    dimensions: ['query', 'page'],
    rowLimit: 25000,
    startRow: 0,
  },
})