> ## 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

> Ask Bing AI Mode (Bing Copilot Search) a question and get its answer, the pages it read and cited, the places it names and the sponsored products above it.

`BING_AIMODE` asks Bing AI Mode, the answer page at bing.com/copilotsearch also known as Bing Copilot Search, as a signed-out visitor in the country you choose.

| | |
| - | - |
| `taskType` | `BING_AIMODE` (aliases `BING_COPILOT_SEARCH`, `COPILOT_SEARCH`) |
| Input | `query` or `prompt` (required), up to 3,500 characters after URL encoding; `country`, `state`, `include` |
| Credits | 1.25 per task |
| Country | Defaults to `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` and `ZA`. Other countries return `422 REGION_UNSUPPORTED`. |
| Location | Accepts `payload.state`. See [Regions and location](https://docs.querying.ai/engines/capacity.md). |

## Request

```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" } }'
```

The task runs asynchronously. Read the result as described in [Async tasks](https://docs.querying.ai/concepts/async-tasks.md). An answer usually completes in 20 to 80 seconds.

## Parameters

| Field | Required | Description |
| - | - | - |
| `query` | Yes, or `prompt` | The question, up to 3,500 characters after URL encoding. |
| `prompt` | Yes, or `query` | Accepted in place of `query`. When a request carries both, `BING_AIMODE` reads `prompt`. |
| `country` | No | The visitor's country, which sets Bing's market and the answer's language. Defaults to `US`. |
| `include.rawResponse` | No | `true` adds the answer page HTML as `rawResponse`. |

## Response

For example:

```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": []
}
```

| Field | Description |
| - | - |
| `text` | The answer as plain text. `[n]` refers to the source with `position: n`. |
| `markdown` | The answer with its headings, bold, lists and tables, and the same `[n]` citations. Returned without any flag. When Bing shows video cards above the answer, the markdown starts with them. |
| `sources` | Every page Bing read for the answer, in Bing's order: `position`, `url`, `label` and `description`. A page the answer read without citing it carries `uncited: true`. A page the answer cites outside that list comes after it. |
| `places` | Places the answer links to their Bing local page: `position`, `name`, `url` and `ypid` (Bing's place id). Empty when the answer names no place. |
| `sponsoredProducts` | The sponsored product cards Bing shows above the answer: `position`, `title`, `url` (the advertiser's page), `merchant`, `price`, `originalPrice` and `image`, plus what the card shows under the merchant: `badge` (e.g. `SALE`), `rating` (out of 5), `reviewCount`, `reviewCountText`, `shipping`, `priceDrop`, `returns`, `notes` and `promotion` (`label`, `description`, `terms`, `code`). `reviewCount` is the exact number; `reviewCountText` is the count as Bing shows it, such as `5K+`. Empty when Bing shows none. |
| `videos` | The video cards Bing shows above the answer: `title`, `url`, `medium: "video"`, `thumbnail`, `source`, `duration`, `channel`, `views`, `date` and `caption`. Empty when Bing shows none. |
| `rawResponse` | The answer page HTML, with `include.rawResponse: true`. |

## How a task runs

Each task opens Bing AI Mode as a new visitor from the country you set, in that country's language. Bing withholds the answer from some visitors, so a task asks again as a new visitor, up to eight times within seven minutes, and completes with the first full answer. A task whose eight tries all end without an answer fails with `ENGINE_FAILED` and uses no credits.

## Include flags

| Flag | Effect |
| - | - |
| `rawResponse` | Adds `rawResponse`. |
| `html` | Adds `html`, the screen Bing AI Mode showed. See [HTML pages](https://docs.querying.ai/engines/html-pages.md). |

`markdown` needs no flag. `ads`, `shopping` and `searchQueries` have no effect. `analysis` is rejected with `422 VALIDATION_ERROR` and `citationAnalysis` with `400 VALIDATION_ERROR`. See [Markdown and raw responses](https://docs.querying.ai/engines/response-options.md).

## Related

* [Bing AI Mode product page](https://querying.ai/en/engines/bing-ai-mode)
* [Bing Search](https://docs.querying.ai/engines/bing-search.md) for the bing.com results page and its AI summary
* [Microsoft Copilot](https://docs.querying.ai/engines/bing-copilot.md) for Microsoft's chat answer
* [Engine overview](https://docs.querying.ai/engines/overview.md)


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