> ## 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 de Bing Search y resumen de IA (BING_SEARCH)

> Obtén los resultados orgánicos, anuncios y búsquedas relacionadas de bing.com, más el resumen de IA que Bing muestra encima.

`BING_SEARCH` carga la página de resultados de bing.com para una consulta y devuelve sus resultados orgánicos, anuncios y búsquedas relacionadas, con el resumen de IA que Bing muestra encima como `aioverview`. No interviene ninguna cuenta ni inicio de sesión.

| | |
| - | - |
| `taskType` | `BING_SEARCH` (alias `BING`, `BING_COPILOT_SEARCH`) |
| Entrada | `query` o `prompt` (obligatorio), hasta 4.000 caracteres; `country`, `include` |
| Créditos | 1 por tarea |
| País | `US` por defecto. Cualquier código ISO 3166-1 alfa-2. |
| Ubicación | No admitida (`422 LOCATION_UNSUPPORTED`). |

## Solicitud

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

La tarea se ejecuta de forma asíncrona. Lee el resultado como se describe en [Tareas asíncronas](/es/concepts/async-tasks.md).

## Parámetros

| Campo | Obligatorio | Descripción |
| - | - | - |
| `query` | Sí, o `prompt` | La consulta de búsqueda, hasta 4.000 caracteres. |
| `prompt` | Sí, o `query` | Se acepta en lugar de `query`. Si una solicitud lleva ambos, `BING_SEARCH` lee `prompt`. |
| `country` | No | El mercado en el que buscar. `US` por defecto. |
| `include.markdown` | No | `true` añade `aioverview.markdown`, el resumen con sus títulos, listas y tablas. |
| `include.rawResponse` | No | `true` añade el HTML completo de la página de resultados como `rawContent`. |

## Respuesta

Por ejemplo:

```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 | Descripción |
| - | - |
| `surface` | Siempre `bing_search`. |
| `organicResults` | Los resultados orgánicos de la página. |
| `ads` | Anuncios; se omite si la página no tiene. |
| `relatedSearches` | Búsquedas relacionadas; se omite si la página no tiene. |
| `aioverview` | El resumen de IA de Bing, o `null` si Bing no mostró ninguno. |
| `aioverview.text` | El resumen. `[n]` remite a `aioverview.sources[n-1]`. |
| `aioverview.sources` | Las páginas que cita el resumen. |
| `aioverview.citationPills` | Una entrada por fuente detrás de una cita en línea; las fuentes citadas juntas comparten un `citationPillId`. Se omite si el resumen no tiene citas en línea. |
| `aioverview.markdown` | Con `include.markdown: true`. |
| `rawContent` | El HTML de la página de resultados, con `include.rawResponse: true`. |
| `text`, `sources` | Copias obsoletas de `aioverview.text` y `aioverview.sources`, vacías si no hay resumen. En código nuevo lee `aioverview`. |

> [!WARNING]
>
> `aioverview: null` significa que Bing no mostró un resumen de IA para esa consulta. No es un error, y los resultados de alrededor se devuelven igualmente.

## Límites y errores

* Un `query` (o `prompt`) de más de 4.000 caracteres devuelve `422 VALIDATION_ERROR`.
* Bing no escribe un resumen para cada consulta; las preguntas de tipo búsqueda lo obtienen con más frecuencia que las instrucciones. Cuando muestra un resumen, Bing mueve parte de los resultados orgánicos a la página siguiente, así que `organicResults` es más corto en esas páginas.
* Los demás errores de solicitud se enumeran en [Errores](/es/concepts/errors.md).

## Relacionado

* [Bing Copilot](/es/engines/bing-copilot.md) para la respuesta del chat de Microsoft
* [Markdown y respuestas en bruto](/es/engines/response-options.md)


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