Bing Webmaster Tools APIの使い方 ― 検索パフォーマンスデータをプログラムで取得する

Bing Webmaster ToolsにはAPIが用意されており、検索パフォーマンスデータ（インプレッション、クリック、掲載順位など）をプログラムから取得できます。本記事ではその概要と使い方を解説します。

APIでできること

Bing Webmaster Tools APIを使うと、以下のようなデータにプログラムからアクセスできます。

• Rank & Traffic Stats ― 日単位のインプレッション数・クリック数
• Link Details ― 被リンク情報
• Keyword Details ― キーワードごとの掲載順位・トラフィック
• Crawl Stats ― クロール統計（クロールされたページ数、クロールエラーなど）
• URLとサイトマップの送信 ― URLの送信・サイトマップの追加

認証方法

認証方法は2種類あります。

1. API Key（簡易）

API KeyはBing Webmaster Toolsの設定画面から生成できます。

1. Bing Webmaster Tools にログイン
2. 右上の Settings → API Access を開く
3. 利用規約に同意し、Generate API Key をクリック

API Keyはユーザー単位で発行されるため、同じユーザーが所有する全サイトに共通で使えます。

2. OAuth 2.0（推奨）

1. Bing Webmaster Toolsの Settings → API Access でOAuth Clientを登録
2. Client IDとClient Secretを発行
3. Authorization Code Flowでアクセストークンを取得
4. リフレッシュトークンで自動更新

スコープ:

• webmaster.read ― 読み取り専用アクセス
• webmaster.manage ― 読み書きアクセス

エンドポイントとプロトコル

APIは3つのプロトコルに対応しています。

JSONエンドポイントが最も扱いやすいです。

主なAPIメソッド

使用例（Node.js）

const API_KEY = 'YOUR_API_KEY';
const SITE_URL = 'https://www.example.com/';

// トラフィック統計を取得
const res = await fetch(
  `https://ssl.bing.com/webmaster/api.svc/json/GetRankAndTrafficStats?apikey=${API_KEY}&siteUrl=${encodeURIComponent(SITE_URL)}`
);
const data = await res.json();
console.log(data);

OAuth 2.0を使う場合は、AuthorizationヘッダーにBearerトークンを指定します。

const res = await fetch(
  'https://ssl.bing.com/webmaster/api.svc/json/SubmitUrl',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${ACCESS_TOKEN}`
    },
    body: JSON.stringify({
      siteUrl: 'https://www.example.com/',
      url: 'https://www.example.com/new-page'
    })
  }
);

Google Search Console APIとの違い

まとめ

Bing Webmaster Tools APIを使うと、検索パフォーマンスデータをプログラムで取得できるため、GA4やAdSenseのデータと統合した分析が可能になります。特にBing経由のトラフィックが多いサイトでは、定期的なデータ取得とレポート自動化に役立ちます。