> ## 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 des résultats Bing Search et du résumé IA (BING_SEARCH)

> Obtenez les résultats organiques, les annonces et les recherches associées de bing.com, avec le résumé IA que Bing affiche au-dessus.

`BING_SEARCH` charge la page de résultats bing.com d'une requête et renvoie ses résultats organiques, ses annonces et ses recherches associées, avec le résumé IA que Bing affiche au-dessus sous `aioverview`. Aucun compte ni connexion n'est utilisé.

| | |
| - | - |
| `taskType` | `BING_SEARCH` (alias `BING`, `BING_COPILOT_SEARCH`) |
| Entrée | `query` ou `prompt` (obligatoire), jusqu'à 4 000 caractères ; `country`, `include` |
| Crédits | 1 par tâche |
| Pays | `US` par défaut. Tout code ISO 3166-1 alpha-2. |
| Position | Non prise en charge (`422 LOCATION_UNSUPPORTED`). |

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

La tâche s'exécute de façon asynchrone. Lisez le résultat comme décrit dans [Tâches asynchrones](/fr/concepts/async-tasks.md).

## Paramètres

| Champ | Obligatoire | Description |
| - | - | - |
| `query` | Oui, ou `prompt` | La requête de recherche, jusqu'à 4 000 caractères. |
| `prompt` | Oui, ou `query` | Accepté à la place de `query`. Quand une requête contient les deux, `BING_SEARCH` lit `prompt`. |
| `country` | Non | Le marché à interroger. `US` par défaut. |
| `include.markdown` | Non | `true` ajoute `aioverview.markdown`, le résumé avec ses titres, listes et tableaux. |
| `include.rawResponse` | Non | `true` ajoute le HTML complet de la page de résultats dans `rawContent`. |

## Réponse

Par exemple :

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

| Champ | Description |
| - | - |
| `surface` | Toujours `bing_search`. |
| `organicResults` | Les résultats organiques de la page. |
| `ads` | Les annonces, omises si la page n'en contient pas. |
| `relatedSearches` | Les recherches associées, omises si la page n'en contient pas. |
| `aioverview` | Le résumé IA de Bing, ou `null` quand Bing n'en a pas affiché. |
| `aioverview.text` | Le résumé. `[n]` renvoie à `aioverview.sources[n-1]`. |
| `aioverview.sources` | Les pages citées par le résumé. |
| `aioverview.citationPills` | Une entrée par source derrière une citation en ligne ; les sources citées ensemble partagent un `citationPillId`. Omis si le résumé n'a pas de citation en ligne. |
| `aioverview.markdown` | Avec `include.markdown: true`. |
| `rawContent` | Le HTML de la page de résultats, avec `include.rawResponse: true`. |
| `text`, `sources` | Copies obsolètes de `aioverview.text` et `aioverview.sources`, vides en l'absence de résumé. Lisez `aioverview` dans le nouveau code. |

> [!WARNING]
>
> `aioverview: null` signifie que Bing n'a pas affiché de résumé IA pour cette requête. Ce n'est pas une erreur, et les résultats autour sont quand même renvoyés.

## Limites et erreurs

* Une `query` (ou un `prompt`) de plus de 4 000 caractères renvoie `422 VALIDATION_ERROR`.
* Bing ne rédige pas de résumé pour chaque requête ; les questions de type recherche en obtiennent plus souvent que les consignes. Quand il affiche un résumé, Bing déplace une partie des résultats organiques vers la page suivante : `organicResults` est donc plus court sur ces pages.
* Les autres erreurs de requête sont listées dans [Erreurs](/fr/concepts/errors.md).

## Voir aussi

* [Bing Copilot](/fr/engines/bing-copilot.md) pour la réponse du chat de Microsoft
* [Markdown et réponses brutes](/fr/engines/response-options.md)


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