Google、Search Console APIで指名検索とレンズ検索の数字を取得可能に

Google、Search Console APIで指名検索とレンズ検索の数字を取得可能に
平山 大樹(AB通信 運営責任者)

平山 大樹 AB通信 運営責任者

AB通信 編集部が、企業・行政の公式発表や決算資料などの一次情報を確認して書いています。運営会社・編集方針

目次

この記事のポイント

  • Googleは2026年11月16日、Search Consoleの検索パフォーマンスデータを取り出す「Search Analytics API」に、3つの機能を追加しました
  • 指名検索(公式名はbranded queries)とそれ以外を、APIで自動的に分けて取得できます。値はBRANDEDとNON_BRANDEDです
  • typeにwebMultimodalを指定すると、Googleレンズ、Androidのかこって検索、Google検索への画像アップロードによる検索の実績を取得できます
  • 新しいfilterListsを使うと、複数の国やデバイスを、1回のリクエストで絞り込めます
  • 指名検索の分類は、対象になるプロパティに限ります。対象外では、行が返らない、と公式は説明しています

Search Analytics APIに、3つの機能が追加されました

Googleは2026年11月16日、Search ConsoleのSearch Analytics APIを更新しました。検索パフォーマンスレポートに、この1年で加わった3つの機能を、データを自動で取り出す仕組み(API)でも使えるようにした、とGoogle Search Central公式ブログで案内しています。

3つの機能は、指名検索(公式ではbranded queries)の絞り込み、ウェブのマルチモーダル検索(Googleレンズ、かこって検索、画像アップロード)の実績、複数の国やデバイスでの絞り込みです。公式は、個別のリクエストをつなぎ合わせたり、キーワードの正規表現リストを維持したりしなくても、自社のダッシュボードや監視の仕組み、外部のツール向けに、報告を自動化しやすくなる、としています。

Search Consoleのこれまでの更新は、Google Search Consoleの最新アップデート・更新履歴にもまとめています。

何ができるようになったか

公式ブログと、Search Console APIの公式リファレンス「Search Analytics: query」(2026年11月16日更新)によると、追加されたのは次の3つです。

図:Search Analytics APIで新たに使える3つの機能。指名検索の分類(brandedClassification)、画像からの検索の実績(type: webMultimodal)、複数の国やデバイスでの絞り込み(filterLists)
出典:Google Search Central公式ブログ「New filtering and reporting capabilities in the Search Analytics API」(2026年11月16日)と、Search Console API公式リファレンス「Search Analytics: query」(2026年11月16日更新)をもとにAB通信が作成

1. 指名検索の分類(brandedClassification)

dimensionsやフィルタにbrandedClassificationを指定すると、指名検索とそれ以外の実績を分けて見られます。使える演算子はequalsだけです。値は、英語版の公式リファレンスではBRANDED(指名)とNON_BRANDED(指名以外)です。

日本語版の公式リファレンスでは、対応する値が「ブランド」とNON_BRANDEDと表示されています。リクエストに入れる値は、英語版に記載されたBRANDEDとNON_BRANDEDを使うのが確実です。

データは2026年2月21日以降分で、クエリ数とインプレッション数が十分な最上位プロパティに限られます。URLパスのプロパティ(例:https://example.com/path)や、サブドメインのプロパティ(例:developers.google.com)は対象外です。対象外のプロパティでは、レスポンスに行が含まれない、と公式ブログは説明しています。

同じリクエストの中で、brandedClassificationのフィルタやグループ化と、queryフィルタを組み合わせることはできません。

指名検索の分類そのものは、2025年11月20日の公式ブログで、検索パフォーマンスレポート向けに発表されています。公式によると、分類はキーワードの正規表現ではなく、AIを使った社内の仕組みで決まります。ブランド名の表記ゆれや誤字、ブランド名を含まなくてもそのサイト独自の製品やサービスを指す検索も含まれます。分類を誤ることがあり、このフィルタは分析用で、検索順位には影響しない、としています。2026年3月11日の追記では、対象となるすべてのサイトで使えるようになった、と案内されています。

2. 画像からの検索の実績(webMultimodal)

typeにwebMultimodalを指定すると、Googleレンズ、Androidのかこって検索、Google検索への画像アップロードによる検索結果の実績を取得できます。一括データエクスポートを使っているプロパティでは、このデータはBigQueryでも利用できる、と公式ブログは案内しています。

検索パフォーマンスレポート側の機能は、2026年9月24日の公式ブログで発表されています。レポートの対象には、上記に加えて、Chromeの右クリック「この画像を検索」も含まれる、と当時の発表では説明されています。一方、今回のAPI公式ブログとAPIリファレンスがwebMultimodalの対象として挙げているのは、Googleレンズ、Androidのかこって検索、Google検索への画像アップロードです。

Search Consoleヘルプ「パフォーマンスレポート(検索結果):ディメンションとデータのグループ化」によると、マルチモーダル検索は主に画像を使うため、検索語句のテキストは得られません。そのため、この検索タイプを選んだときは、レポート上でクエリ(検索語句)のディメンションは使えない、としています。

3. 複数の国・デバイスでの絞り込み(filterLists)

新しいfilterListsを使うと、1つのディメンションに対して、複数の値への完全一致を、1回のリクエストで指定できます。公式リファレンスによると、行の値がexpressionsのいずれかと等しいときに一致します。

使えるディメンションは、次の2つだけです。

  • country:国を、3文字の国コード(ISO 3166-1 alpha-3)で指定します
  • device:デバイスを、DESKTOP、MOBILE、TABLETで指定します

同じリクエストで、同じディメンションをfiltersとfilterListsの両方に置くことはできません。公式ブログは、EMEA、LATAM、DACHのような地域のまとまりを、1回の呼び出しで問い合わせられる、と説明しています。

どのような場面で使うか

公式ブログによると、サイト運営者、複数の国で事業を行う企業、外部ツールの開発者が、規模の大きな報告を自動化しやすくなります。指名検索とそれ以外を、ダッシュボード上で自動的に分けたり、マルチモーダル検索の数字を、ほかのGoogle検索の結果と並べて追ったりできます。

これらのフィルタは組み合わせて使えます。公式は、特定の地域の拠点ごとにブランドの伸びを見たり、主要な市場やデバイスごとに、マルチモーダル検索でよく見られているページを確認したりできる、としています。

自社のダッシュボードやSEOツールにAPIで取り込み、指名検索とそれ以外を自動で分ける、といった使い方が想定されます。Looker StudioなどのBIツールに、APIで取得した数字を載せることも考えられます。ただし、Looker Studioの標準コネクタが、今回の項目に対応したかどうかは、今回の公式発表には書かれていません。

始め方

公式の前提条件とAPIリファレンスによると、次の準備が必要です。

  1. 対象のSearch Consoleプロパティに対する権限を持ったGoogleアカウント。searchAnalytics.queryを使うには、そのプロパティの閲覧権限が必要です
  2. Google API Console(Google Cloud)でプロジェクトを作り、Search Console APIへのアクセスを有効にし、OAuth 2.0の認証情報を用意します。Testing Tools API以外のSearch Console APIは、OAuth 2.0が必要です
  3. 認可のスコープは、https://www.googleapis.com/auth/webmasters.readonly(読み取り専用)またはhttps://www.googleapis.com/auth/webmastersです
  4. データを取るときは、次のエンドポイントにPOSTします。https://www.googleapis.com/webmasters/v3/sites/{siteUrl}/searchAnalytics/query。siteUrlは、URLプレフィックスプロパティならhttp://www.example.com/、ドメインプロパティならsc-domain:example.comのように指定します

リクエストの本文には、期間を表すstartDateとendDate(YYYY-MM-DD形式、太平洋時間)が必須です。詳細とPythonのサンプルは、公式リファレンス「Search Analytics: query」と、Pythonクイックスタートにあります。

リクエスト例

公式ブログには、新しい項目の完全なリクエスト例は載っていません。次の図は、公式リファレンスに書かれた項目名と値で組み立てた例です。日付や対象サイトは、実際の期間とプロパティに置き換えてください。指名検索の例は、公式がデータの開始日としている2026年2月21日からにしています。

図:Search Analytics APIのリクエスト例(1)。指名検索の分類はdimensionsにbrandedClassification、画像からの検索はtypeをwebMultimodalに指定
出典:Search Console API公式リファレンス「Search Analytics: query」(2026年11月16日更新)をもとにAB通信が作成。公式がそのまま掲載したサンプルではなく、公式の項目名と値で組み立てた例です
図:Search Analytics APIのリクエスト例(2)。複数の国の絞り込みはfilterListsでcountryにDEU、AUT、CHEを指定
出典:Search Console API公式リファレンス「Search Analytics: query」(2026年11月16日更新)と、Google Search Central公式ブログ(2026年11月16日)をもとにAB通信が作成。公式がそのまま掲載したサンプルではなく、公式の項目名と値で組み立てた例です

公式が「組み合わせて使える」としている例に沿うと、たとえば指名検索だけを、複数の国に絞って取ることもできます。次は、DACH(ドイツ、オーストリア、スイス)の指名検索を取る例です。brandedClassificationはfilters、countryはfilterListsに置いており、同じディメンションを両方に置く形にはしていません。

{
  "startDate": "2026-02-21",
  "endDate": "2026-11-16",
  "dimensions": ["date", "country"],
  "dimensionFilterGroups": [
    {
      "groupType": "and",
      "filters": [
        {
          "dimension": "brandedClassification",
          "operator": "equals",
          "expression": "BRANDED"
        }
      ],
      "filterLists": [
        {
          "dimension": "country",
          "expressions": ["DEU", "AUT", "CHE"]
        }
      ]
    }
  ]
}

使うときの注意点

  • 指名検索の分類は、条件を満たす最上位プロパティだけが対象です。対象外では行が返りません
  • brandedClassificationのフィルタやグループ化は、同じリクエストのqueryフィルタと併用できません
  • 分類はAIを使った社内の仕組みで決まり、誤ることがあります。分析用の区分で、検索順位には影響しません
  • filterListsで使えるのは、国(country)とデバイス(device)だけです。同じディメンションをfiltersとfilterListsの両方には置けません
  • APIはSearch Consoleの内部的な上限の範囲で動き、すべての行ではなく、上位の行を返す、と公式リファレンスは注記しています。rowLimitの範囲は1〜25,000、既定は1,000です。続きを取るときはstartRowを使います
  • 期間の日付は太平洋時間(PT)です

公式の案内

今回の更新の一次情報は、次の公式ページです。

営業メールなし/無料

AI・SEOの動きは、
毎朝7時のメールで追いつける

平山 大樹(AB通信 運営責任者)

毎朝6時に私がピックアップしてます!

平山 大樹|AB通信 運営責任者

AB通信のメール配信イメージ

もうXを追いかけなくていい。前日にAB通信で公開したAI・SEOの新着記事を、朝のうちにまとめてお届けします。

毎朝7時ごろ、前日のAI・SEOの新着記事をメールでお届けします。

営業メールは送りません。無料で、配信はいつでも解除できます。
登録後に届く確認メールの「登録を確定する」ボタンで完了です(迷惑メールフォルダもご確認ください)。

目次