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

# API do Bing AI Mode

> Pergunte ao Bing AI Mode (Bing Copilot Search) e receba a resposta, as páginas que ele leu e citou, os lugares que menciona e os produtos patrocinados acima dela.

`BING_AIMODE` pergunta ao Bing AI Mode, a página de respostas de bing.com/copilotsearch também chamada de Bing Copilot Search, como um visitante sem login do país escolhido.

| | |
| - | - |
| `taskType` | `BING_AIMODE` (aliases `BING_COPILOT_SEARCH`, `COPILOT_SEARCH`) |
| Entrada | `query` ou `prompt` (obrigatório), até 3.500 caracteres após codificação URL; `country`, `state`, `include` |
| Créditos | 1,25 por tarefa |
| País | Padrão `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` e `ZA`. Outros países retornam `422 REGION_UNSUPPORTED`. |
| Localização | Aceita `payload.state`. Veja [Regiões e localização](https://docs.querying.ai/pt/engines/capacity.md). |

## Requisição

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

A tarefa roda de forma assíncrona. Leia o resultado como descrito em [Tarefas assíncronas](https://docs.querying.ai/pt/concepts/async-tasks.md). Uma resposta costuma ficar pronta em 20 a 80 segundos.

## Parâmetros

| Campo | Obrigatório | Descrição |
| - | - | - |
| `query` | Sim, ou `prompt` | A pergunta, até 3.500 caracteres após codificação URL; escritas não latinas chegam ao limite antes. |
| `prompt` | Sim, ou `query` | Aceito no lugar de `query`. Quando a requisição traz os dois, `BING_AIMODE` lê `prompt`. |
| `country` | Não | O país do visitante, que define o mercado do Bing e o idioma da resposta. Padrão `US`. |
| `include.rawResponse` | Não | `true` adiciona o HTML da página de resposta como `rawResponse`. |

## Resposta

Por exemplo:

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

| Campo | Descrição |
| - | - |
| `text` | A resposta em texto simples. `[n]` se refere à fonte com `position: n`. |
| `markdown` | A resposta com títulos, negrito, listas e tabelas, e as mesmas citações `[n]`. Retornado sem nenhuma opção. Quando o Bing mostra cards de vídeo acima da resposta, o markdown começa com eles. |
| `sources` | Todas as páginas que o Bing leu para a resposta, na ordem do Bing: `position`, `url`, `label` e `description`. Uma página lida sem ser citada traz `uncited: true`. Uma página que a resposta cita fora dessa lista vem depois. |
| `places` | Os lugares que a resposta liga à página local do Bing: `position`, `name`, `url` e `ypid` (o id de lugar do Bing). Vazio quando a resposta não menciona lugares. |
| `sponsoredProducts` | Os cards de produtos patrocinados que o Bing mostra acima da resposta: `position`, `title`, `url` (a página do anunciante), `merchant`, `price`, `originalPrice` e `image`, além do que o card mostra abaixo do lojista: `badge` (ex.: `SALE`), `rating` (de 5), `reviewCount`, `reviewCountText`, `shipping`, `priceDrop`, `returns`, `notes` e `promotion` (`label`, `description`, `terms`, `code`). `reviewCount` é o número exato; `reviewCountText` é a contagem como o Bing mostra, como `5K+`. Vazio quando o Bing não mostra nenhum. |
| `videos` | Os cards de vídeo que o Bing mostra acima da resposta: `title`, `url`, `medium: "video"`, `thumbnail`, `source`, `duration`, `channel`, `views`, `date` e `caption`. Vazio quando o Bing não mostra nenhum. |
| `rawResponse` | O HTML da página de resposta, com `include.rawResponse: true`. |

## Como uma tarefa roda

Cada tarefa abre o Bing AI Mode como um novo visitante do país escolhido, no idioma desse país. O Bing mostra a resposta só a parte dos visitantes, então a tarefa pergunta de novo como novo visitante até oito vezes em sete minutos e termina com a primeira resposta completa. Uma tarefa cujas oito tentativas terminam sem resposta falha com `ENGINE_FAILED` e não consome créditos.

## Opções include

| Opção | Efeito |
| - | - |
| `rawResponse` | Adiciona `rawResponse`. |
| `html` | Adiciona `html`, a tela que o Bing AI Mode mostrou. Veja [Páginas HTML](https://docs.querying.ai/pt/engines/html-pages.md). |

`markdown` não precisa de opção. `ads`, `shopping` e `searchQueries` não têm efeito. `analysis` é recusado com `422 VALIDATION_ERROR` e `citationAnalysis` com `400 VALIDATION_ERROR`. Veja [Markdown e respostas brutas](https://docs.querying.ai/pt/engines/response-options.md).

## Relacionado

* [Página do produto Bing AI Mode](https://querying.ai/pt/engines/bing-ai-mode)
* [Bing Search](https://docs.querying.ai/pt/engines/bing-search.md) para a página de resultados do bing.com e seu resumo de IA
* [Microsoft Copilot](https://docs.querying.ai/pt/engines/bing-copilot.md) para a resposta de chat da Microsoft
* [Visão geral dos motores](https://docs.querying.ai/pt/engines/overview.md)


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