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

> Posez une question à Bing AI Mode (Bing Copilot Search) et recevez sa réponse, les pages lues et citées, les lieux nommés et les produits sponsorisés affichés au-dessus.

`BING_AIMODE` interroge Bing AI Mode, la page de réponses de bing.com/copilotsearch aussi appelée Bing Copilot Search, en visiteur non connecté du pays choisi.

| | |
| - | - |
| `taskType` | `BING_AIMODE` (alias `BING_COPILOT_SEARCH`, `COPILOT_SEARCH`) |
| Entrée | `query` ou `prompt` (obligatoire), jusqu'à 3 500 caractères après encodage URL ; `country`, `state`, `include` |
| Crédits | 1,25 par tâche |
| Pays | `US` par défaut. `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` et `ZA`. Les autres pays renvoient `422 REGION_UNSUPPORTED`. |
| Localisation | Accepte `payload.state`. Consultez [Régions et localisation](https://docs.querying.ai/fr/engines/capacity.md). |

## Requête

```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 tâche s'exécute de manière asynchrone. Lisez le résultat comme décrit dans [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md). Une réponse arrive en général en 20 à 80 secondes.

## Paramètres

| Champ | Obligatoire | Description |
| - | - | - |
| `query` | Oui, ou `prompt` | La question, jusqu'à 3 500 caractères après encodage URL ; les écritures non latines atteignent la limite plus tôt. |
| `prompt` | Oui, ou `query` | Accepté à la place de `query`. Si la requête porte les deux, `BING_AIMODE` lit `prompt`. |
| `country` | Non | Le pays du visiteur, qui fixe le marché Bing et la langue de la réponse. `US` par défaut. |
| `include.rawResponse` | Non | `true` ajoute le HTML de la page de réponse dans `rawResponse`. |

## Réponse

Par exemple :

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

| Champ | Description |
| - | - |
| `text` | La réponse en texte brut. `[n]` renvoie à la source dont `position: n`. |
| `markdown` | La réponse avec ses titres, son gras, ses listes et ses tableaux, et les mêmes citations `[n]`. Renvoyé sans option. Quand Bing affiche des fiches vidéo au-dessus de la réponse, le markdown commence par elles. |
| `sources` | Toutes les pages que Bing a lues pour la réponse, dans l'ordre de Bing : `position`, `url`, `label` et `description`. Une page lue sans être citée porte `uncited: true`. Une page citée par la réponse hors de cette liste vient après. |
| `places` | Les lieux que la réponse relie à leur page locale Bing : `position`, `name`, `url` et `ypid` (l'identifiant de lieu Bing). Vide quand la réponse ne nomme aucun lieu. |
| `sponsoredProducts` | Les fiches de produits sponsorisés que Bing affiche au-dessus de la réponse : `position`, `title`, `url` (la page de l'annonceur), `merchant`, `price`, `originalPrice` et `image`, plus ce que la fiche affiche sous le marchand : `badge` (par ex. `SALE`), `rating` (sur 5), `reviewCount`, `reviewCountText`, `shipping`, `priceDrop`, `returns`, `notes` et `promotion` (`label`, `description`, `terms`, `code`). `reviewCount` est le nombre exact ; `reviewCountText` est le nombre tel que Bing l'affiche, comme `5K+`. Vide quand Bing n'en affiche aucune. |
| `videos` | Les fiches vidéo que Bing affiche au-dessus de la réponse : `title`, `url`, `medium: "video"`, `thumbnail`, `source`, `duration`, `channel`, `views`, `date` et `caption`. Vide quand Bing n'en affiche aucune. |
| `rawResponse` | Le HTML de la page de réponse, avec `include.rawResponse: true`. |

## Déroulement d'une tâche

Chaque tâche ouvre Bing AI Mode en nouveau visiteur du pays choisi, dans la langue de ce pays. Bing réserve la réponse à une partie de ses visiteurs : la tâche repose donc la question en nouveau visiteur, jusqu'à huit fois en sept minutes, et se termine avec la première réponse complète. Une tâche dont les huit essais restent sans réponse échoue avec `ENGINE_FAILED` et ne consomme aucun crédit.

## Options include

| Option | Effet |
| - | - |
| `rawResponse` | Ajoute `rawResponse`. |
| `html` | Ajoute `html`, l'écran affiché par Bing AI Mode. Voir [Pages HTML](https://docs.querying.ai/fr/engines/html-pages.md). |

`markdown` ne demande aucune option. `ads`, `shopping` et `searchQueries` sont sans effet. `analysis` est refusé avec `422 VALIDATION_ERROR` et `citationAnalysis` avec `400 VALIDATION_ERROR`. Voir [Markdown et réponses brutes](https://docs.querying.ai/fr/engines/response-options.md).

## Voir aussi

* [Page produit Bing AI Mode](https://querying.ai/fr/engines/bing-ai-mode)
* [Bing Search](https://docs.querying.ai/fr/engines/bing-search.md) pour la page de résultats bing.com et son résumé IA
* [Microsoft Copilot](https://docs.querying.ai/fr/engines/bing-copilot.md) pour la réponse du chat de Microsoft
* [Présentation des moteurs](https://docs.querying.ai/fr/engines/overview.md)


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