> ## 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 Bing AI Mode

> Pregunta a Bing AI Mode (Bing Copilot Search) y recibe su respuesta, las páginas que leyó y citó, los lugares que nombra y los productos patrocinados que aparecen encima.

`BING_AIMODE` pregunta a Bing AI Mode, la página de respuestas de bing.com/copilotsearch también conocida como Bing Copilot Search, como un visitante sin sesión iniciada del país que elijas.

| | |
| - | - |
| `taskType` | `BING_AIMODE` (alias `BING_COPILOT_SEARCH`, `COPILOT_SEARCH`) |
| Entrada | `query` o `prompt` (obligatorio), hasta 3.500 caracteres tras la codificación URL; `country`, `state`, `include` |
| Créditos | 1,25 por tarea |
| País | `US` por defecto. `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` y `ZA`. Los demás países devuelven `422 REGION_UNSUPPORTED`. |
| Ubicación | Acepta `payload.state`. Consulta [Regiones y ubicación](https://docs.querying.ai/es/engines/capacity.md). |

## 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_AIMODE", "payload": { "query": "best wireless earbuds for commuting", "country": "US" } }'
```

La tarea se ejecuta de forma asíncrona. Lee el resultado como se describe en [Tareas asíncronas](https://docs.querying.ai/es/concepts/async-tasks.md). Una respuesta suele completarse en 20 a 80 segundos.

## Parámetros

| Campo | Obligatorio | Descripción |
| - | - | - |
| `query` | Sí, o `prompt` | La pregunta, hasta 3.500 caracteres tras la codificación URL; las escrituras no latinas llegan antes al límite. |
| `prompt` | Sí, o `query` | Se acepta en lugar de `query`. Si la solicitud lleva ambos, `BING_AIMODE` lee `prompt`. |
| `country` | No | El país del visitante, que fija el mercado de Bing y el idioma de la respuesta. `US` por defecto. |
| `include.rawResponse` | No | `true` añade el HTML de la página de respuesta como `rawResponse`. |

## Respuesta

Por ejemplo:

```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 | Descripción |
| - | - |
| `text` | La respuesta en texto plano. `[n]` remite a la fuente con `position: n`. |
| `markdown` | La respuesta con sus encabezados, negritas, listas y tablas, y las mismas citas `[n]`. Se devuelve sin ninguna opción. Cuando Bing muestra tarjetas de vídeo encima de la respuesta, el markdown empieza con ellas. |
| `sources` | Todas las páginas que Bing leyó para la respuesta, en el orden de Bing: `position`, `url`, `label` y `description`. Una página leída sin citarla lleva `uncited: true`. Una página que la respuesta cita fuera de esa lista va después. |
| `places` | Los lugares que la respuesta enlaza a su página local de Bing: `position`, `name`, `url` y `ypid` (el id de lugar de Bing). Vacío cuando la respuesta no nombra lugares. |
| `sponsoredProducts` | Las tarjetas de productos patrocinados que Bing muestra encima de la respuesta: `position`, `title`, `url` (la página del anunciante), `merchant`, `price`, `originalPrice` e `image`, más lo que la tarjeta muestra bajo el comercio: `badge` (p. ej. `SALE`), `rating` (sobre 5), `reviewCount`, `reviewCountText`, `shipping`, `priceDrop`, `returns`, `notes` y `promotion` (`label`, `description`, `terms`, `code`). `reviewCount` es el número exacto; `reviewCountText` es el recuento tal como lo muestra Bing, como `5K+`. Vacío cuando Bing no muestra ninguna. |
| `videos` | Las tarjetas de vídeo que Bing muestra encima de la respuesta: `title`, `url`, `medium: "video"`, `thumbnail`, `source`, `duration`, `channel`, `views`, `date` y `caption`. Vacío cuando Bing no muestra ninguna. |
| `rawResponse` | El HTML de la página de respuesta, con `include.rawResponse: true`. |

## Cómo se ejecuta una tarea

Cada tarea abre Bing AI Mode como un visitante nuevo del país que indiques, en el idioma de ese país. Bing reserva la respuesta a una parte de sus visitantes, así que la tarea vuelve a preguntar como visitante nuevo hasta ocho veces en siete minutos y se completa con la primera respuesta completa. Una tarea cuyos ocho intentos terminan sin respuesta falla con `ENGINE_FAILED` y no consume créditos.

## Opciones include

| Opción | Efecto |
| - | - |
| `rawResponse` | Añade `rawResponse`. |
| `html` | Añade `html`, la pantalla que mostró Bing AI Mode. Consulta [Páginas HTML](https://docs.querying.ai/es/engines/html-pages.md). |

`markdown` no necesita opción. `ads`, `shopping` y `searchQueries` no tienen efecto. `analysis` se rechaza con `422 VALIDATION_ERROR` y `citationAnalysis` con `400 VALIDATION_ERROR`. Consulta [Markdown y respuestas en bruto](https://docs.querying.ai/es/engines/response-options.md).

## Relacionado

* [Página de producto de Bing AI Mode](https://querying.ai/es/engines/bing-ai-mode)
* [Bing Search](https://docs.querying.ai/es/engines/bing-search.md) para la página de resultados de bing.com y su resumen de IA
* [Microsoft Copilot](https://docs.querying.ai/es/engines/bing-copilot.md) para la respuesta del chat de Microsoft
* [Resumen de motores](https://docs.querying.ai/es/engines/overview.md)


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