> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bing AI Mode API

> Bing AI Mode(Bing Copilot Search)に質問し、回答、読んで引用したページ、回答に出てくる場所、回答の上のスポンサー商品を取得します。

`BING_AIMODE` は、bing.com/copilotsearch の回答ページである Bing AI Mode(Bing Copilot Search とも呼ばれます)に、指定した国のサインアウト状態の訪問者として質問します。

| | |
| - | - |
| `taskType` | `BING_AIMODE`(エイリアス `BING_COPILOT_SEARCH`、`COPILOT_SEARCH`) |
| 入力 | `query` または `prompt`(必須)、URLエンコードで3,500文字まで。`country`、`state`、`include` |
| クレジット | タスクあたり1.25 |
| 国 | 既定値は `US`。`AE`、`AU`、`BR`、`CA`、`DE`、`EE`、`ES`、`FR`、`GB`、`HK`、`HU`、`IE`、`IN`、`IT`、`JP`、`MX`、`NL`、`PL`、`PT`、`RO`、`RS`、`SE`、`SG`、`SK`、`TR`、`US`、`ZA` に対応し、その他の国は `422 REGION_UNSUPPORTED` を返します。 |
| 位置情報 | `payload.state` を受け付けます。[地域と位置情報](https://docs.querying.ai/ja/engines/capacity.md)を参照してください。 |

## リクエスト

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "BING_AIMODE", "payload": { "query": "best wireless earbuds for commuting", "country": "US" } }'
```

タスクは非同期で実行されます。結果は[非同期タスク](https://docs.querying.ai/ja/concepts/async-tasks.md)の手順で読み取ります。回答は通常20〜80秒で完了します。

## パラメータ

| フィールド | 必須 | 説明 |
| - | - | - |
| `query` | はい、または `prompt` | 質問。URLエンコードで3,500文字まで。日本語などはそれより少なくなります。 |
| `prompt` | はい、または `query` | `query` の代わりに受け付けます。両方あると `BING_AIMODE` は `prompt` を読みます。 |
| `country` | いいえ | 訪問者の国。Bing の市場と回答の言語を決めます。既定値は `US`。 |
| `include.rawResponse` | いいえ | `true` で回答ページの HTML を `rawResponse` として追加します。 |

## レスポンス

例:

```json theme={"theme":"css-variables"}
{
  "text": "The Bose QC Ultra Earbuds 2nd Gen, Samsung Galaxy Buds 3 Pro, and Sony WF‑1000XM6 offer the strongest mix of ANC and battery life for daily commuting. ...",
  "markdown": "The **Bose QC Ultra Earbuds 2nd Gen**, **Samsung Galaxy Buds 3 Pro**, and **Sony WF‑1000XM6** offer ... [1]",
  "sources": [
    { "position": 1, "url": "https://pickclarity.com/guides/best-noise-cancelling-earbuds-for-commuting", "label": "Noise Cancelling Earbuds for Commuting — Fit, Battery & Trade-offs", "description": "The best ANC earbuds for commuting in 2026. ..." },
    { "position": 2, "url": "https://headphoneinfatuation.com/best-earbuds-for-commuting/", "label": "10 Best Earbuds for Commuting of 2026", "description": "...", "uncited": true }
  ],
  "places": [],
  "sponsoredProducts": [
    { "position": 1, "title": "Soundcore By Anker Liberty 5 True Wireless Noise-Canceling Earbuds", "url": "https://www.bhphotovideo.com/...", "merchant": "B&H Photo-Video-Pro A", "price": "$89.99", "originalPrice": "$129.99", "image": "https://th.bing.com/th/id/..." }
  ],
  "videos": []
}
```

| フィールド | 説明 |
| - | - |
| `text` | プレーンテキストの回答。`[n]` は `position: n` の出典を指します。 |
| `markdown` | 見出し、太字、リスト、表と同じ `[n]` 引用を含む回答。フラグなしで返ります。Bing が回答の上に動画カードを表示すると、markdown はそのカードから始まります。 |
| `sources` | Bing が回答のために読んだすべてのページを Bing の順で返します。`position`、`url`、`label`、`description` を持ち、読んだが引用しなかったページには `uncited: true` が付きます。 回答がその一覧にないページを引用した場合は、その後に続きます。 |
| `places` | 回答が Bing のローカルページにリンクした場所。`position`、`name`、`url`、`ypid`(Bing の場所 id)。回答に場所がなければ空です。 |
| `sponsoredProducts` | Bing が回答の上に表示するスポンサー商品カード。`position`、`title`、`url`(広告主のページ)、`merchant`、`price`、`originalPrice`、`image` に加え、カードが販売元の下に表示する `badge`(例: `SALE`)、`rating`(5 点満点)、`reviewCount`、`reviewCountText`、`shipping`、`priceDrop`、`returns`、`notes`、`promotion`(`label`、`description`、`terms`、`code`)。`reviewCount` は正確な数、`reviewCountText` は `5K+` のように Bing の表示どおりの値です。Bing が表示しなければ空です。 |
| `videos` | Bing が回答の上に表示する動画カード。`title`、`url`、`medium: "video"`、`thumbnail`、`source`、`duration`、`channel`、`views`、`date`、`caption`。Bing が表示しなければ空です。 |
| `rawResponse` | `include.rawResponse: true` のときの回答ページ HTML。 |

## タスクの進み方

各タスクは、指定した国の新しい訪問者としてその国の言語で Bing AI Mode を開きます。Bing は一部の訪問者に回答を表示しないため、タスクは7分以内に最大8回まで新しい訪問者として質問し直し、最初に完成した回答で完了します。8回とも回答がなかったタスクは `ENGINE_FAILED` で失敗し、クレジットを消費しません。

## includeフラグ

| フラグ | 効果 |
| - | - |
| `rawResponse` | `rawResponse` を追加します。 |
| `html` | Bing AI Mode が表示した画面 `html` を追加します。[HTMLページ](https://docs.querying.ai/ja/engines/html-pages.md)を参照してください。 |

`markdown` にフラグは不要です。`ads`、`shopping`、`searchQueries` は効果がありません。`analysis` は `422 VALIDATION_ERROR`、`citationAnalysis` は `400 VALIDATION_ERROR` で拒否されます。[Markdownと生レスポンス](https://docs.querying.ai/ja/engines/response-options.md)を参照してください。

## 関連ページ

* [Bing AI Mode製品ページ](https://querying.ai/ja/engines/bing-ai-mode)
* [Bing 検索](https://docs.querying.ai/ja/engines/bing-search.md): bing.com の結果ページとAI要約
* [Microsoft Copilot](https://docs.querying.ai/ja/engines/bing-copilot.md): Microsoft のチャット回答
* [エンジンの概要](https://docs.querying.ai/ja/engines/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.