> ## 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 de resultados e resumo de IA do Bing Search (BING_SEARCH)

> Receba os resultados orgânicos, anúncios e buscas relacionadas do bing.com, com o resumo de IA que o Bing mostra acima deles.

`BING_SEARCH` carrega a página de resultados do bing.com para uma consulta e retorna seus resultados orgânicos, anúncios e buscas relacionadas, com o resumo de IA que o Bing mostra acima deles como `aioverview`. Não há conta nem login envolvidos.

| | |
| - | - |
| `taskType` | `BING_SEARCH` (aliases `BING`, `BING_COPILOT_SEARCH`) |
| Entrada | `query` ou `prompt` (obrigatório), até 4.000 caracteres; `country`, `include` |
| Créditos | 1 por tarefa |
| País | Padrão `US`. Qualquer código ISO 3166-1 alfa-2. |
| Localização | Não suportada (`422 LOCATION_UNSUPPORTED`). |

## 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_SEARCH", "payload": { "query": "how does a heat pump work in cold weather", "country": "US", "include": { "markdown": true } } }'
```

A tarefa roda de forma assíncrona. Leia o resultado como descrito em [Tarefas assíncronas](/pt/concepts/async-tasks.md).

## Parâmetros

| Campo | Obrigatório | Descrição |
| - | - | - |
| `query` | Sim, ou `prompt` | A consulta de busca, até 4.000 caracteres. |
| `prompt` | Sim, ou `query` | Aceito no lugar de `query`. Quando a requisição traz os dois, o `BING_SEARCH` lê `prompt`. |
| `country` | Não | O mercado a buscar. Padrão `US`. |
| `include.markdown` | Não | `true` adiciona `aioverview.markdown`, o resumo com seus títulos, listas e tabelas. |
| `include.rawResponse` | Não | `true` adiciona o HTML completo da página de resultados como `rawContent`. |

## Resposta

Por exemplo:

```json theme={"theme":"css-variables"}
{
  "surface": "bing_search",
  "organicResults": [
    { "position": 1, "title": "...", "link": "https://...", "displayedLink": "...", "snippet": "...", "date": "Aug 3, 2026", "page": 1 }
  ],
  "ads": [{ "position": 1, "title": "...", "link": "https://...", "displayedLink": "...", "description": "...", "blockPosition": "top" }],
  "relatedSearches": [{ "query": "...", "link": "https://www.bing.com/search?q=..." }],
  "aioverview": {
    "text": "Heat pumps move heat instead of generating it [1]. ...",
    "sources": [{ "position": 1, "url": "https://...", "label": "..." }],
    "citationPills": [{ "citationPillId": 1, "position": 1, "url": "https://...", "label": "...", "domain": "example.com" }],
    "markdown": "..."
  },
  "text": "Heat pumps move heat instead of generating it [1]. ...",
  "sources": [{ "position": 1, "url": "https://...", "label": "..." }]
}
```

| Campo | Descrição |
| - | - |
| `surface` | Sempre `bing_search`. |
| `organicResults` | Os resultados orgânicos da página. |
| `ads` | Anúncios, omitido quando a página não tem nenhum. |
| `relatedSearches` | Buscas relacionadas, omitido quando a página não tem nenhuma. |
| `aioverview` | O resumo de IA do Bing, ou `null` quando o Bing não mostrou nenhum. |
| `aioverview.text` | O resumo. `[n]` se refere a `aioverview.sources[n-1]`. |
| `aioverview.sources` | As páginas que o resumo cita. |
| `aioverview.citationPills` | Uma entrada por fonte por trás de uma citação inline; fontes citadas juntas compartilham um `citationPillId`. Omitido quando o resumo não tem citações inline. |
| `aioverview.markdown` | Com `include.markdown: true`. |
| `rawContent` | O HTML da página de resultados, com `include.rawResponse: true`. |
| `text`, `sources` | Cópias obsoletas de `aioverview.text` e `aioverview.sources`, vazias quando não há resumo. Em código novo, leia `aioverview`. |

> [!WARNING]
>
> `aioverview: null` significa que o Bing não mostrou um resumo de IA para aquela consulta. Não é erro, e os resultados ao redor continuam sendo retornados.

## Limites e erros

* Uma `query` (ou `prompt`) com mais de 4.000 caracteres retorna `422 VALIDATION_ERROR`.
* O Bing não escreve um resumo para toda consulta; perguntas do tipo busca recebem resumo com mais frequência do que instruções. Quando mostra um resumo, o Bing move parte dos resultados orgânicos para a página seguinte, então `organicResults` fica mais curto nessas páginas.
* Os demais erros de requisição estão em [Erros](/pt/concepts/errors.md).

## Relacionados

* [Bing Copilot](/pt/engines/bing-copilot.md) para a resposta de chat da Microsoft
* [Markdown e respostas brutas](/pt/engines/response-options.md)


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