> ## 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.

# Bing AI Mode API

> Stellen Sie Bing AI Mode (Bing Copilot Search) eine Frage und erhalten Sie die Antwort, die gelesenen und zitierten Seiten, die genannten Orte und die gesponserten Produkte darüber.

`BING_AIMODE` fragt Bing AI Mode, die Antwortseite unter bing.com/copilotsearch, auch Bing Copilot Search genannt, als abgemeldeter Besucher aus dem gewählten Land.

| | |
| - | - |
| `taskType` | `BING_AIMODE` (Aliasse `BING_COPILOT_SEARCH`, `COPILOT_SEARCH`) |
| Eingabe | `query` oder `prompt` (Pflicht), bis zu 3.500 Zeichen nach URL-Kodierung; `country`, `state`, `include` |
| Credits | 1,25 pro Task |
| Land | Standard ist `US`. `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` und `ZA`. Andere Länder erhalten `422 REGION_UNSUPPORTED`. |
| Standort | Akzeptiert `payload.state`. Siehe [Regionen und Standort](https://docs.querying.ai/de/engines/capacity.md). |

## Anfrage

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

Der Task läuft asynchron. Lesen Sie das Ergebnis wie unter [Asynchrone Tasks](https://docs.querying.ai/de/concepts/async-tasks.md) beschrieben. Eine Antwort ist meist nach 20 bis 80 Sekunden fertig.

## Parameter

| Feld | Pflicht | Beschreibung |
| - | - | - |
| `query` | Ja, oder `prompt` | Die Frage, bis zu 3.500 Zeichen nach URL-Kodierung; nicht-lateinische Schrift erreicht die Grenze früher. |
| `prompt` | Ja, oder `query` | Wird anstelle von `query` akzeptiert. Enthält eine Anfrage beide, liest `BING_AIMODE` `prompt`. |
| `country` | Nein | Das Land des Besuchers. Es legt Bings Markt und die Sprache der Antwort fest. Standard ist `US`. |
| `include.rawResponse` | Nein | `true` fügt das HTML der Antwortseite als `rawResponse` hinzu. |

## Antwort

Zum Beispiel:

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

| Feld | Beschreibung |
| - | - |
| `text` | Die Antwort als reiner Text. `[n]` verweist auf die Quelle mit `position: n`. |
| `markdown` | Die Antwort mit Überschriften, Fettdruck, Listen und Tabellen und denselben `[n]`-Zitaten. Kommt ohne Flag. Zeigt Bing Videokarten über der Antwort, beginnt das Markdown mit ihnen. |
| `sources` | Alle Seiten, die Bing für die Antwort gelesen hat, in Bings Reihenfolge: `position`, `url`, `label` und `description`. Eine gelesene, aber nicht zitierte Seite trägt `uncited: true`. Eine Seite, die die Antwort außerhalb dieser Liste zitiert, folgt danach. |
| `places` | Orte, die die Antwort mit ihrer lokalen Bing-Seite verlinkt: `position`, `name`, `url` und `ypid` (Bings Orts-ID). Leer, wenn die Antwort keinen Ort nennt. |
| `sponsoredProducts` | Die gesponserten Produktkarten, die Bing über der Antwort zeigt: `position`, `title`, `url` (die Seite des Werbetreibenden), `merchant`, `price`, `originalPrice` und `image`, dazu was die Karte unter dem Händler zeigt: `badge` (z. B. `SALE`), `rating` (von 5), `reviewCount`, `reviewCountText`, `shipping`, `priceDrop`, `returns`, `notes` und `promotion` (`label`, `description`, `terms`, `code`). `reviewCount` ist die genaue Zahl, `reviewCountText` die Zahl, wie Bing sie zeigt, etwa `5K+`. Leer, wenn Bing keine zeigt. |
| `videos` | Die Videokarten, die Bing über der Antwort zeigt: `title`, `url`, `medium: "video"`, `thumbnail`, `source`, `duration`, `channel`, `views`, `date` und `caption`. Leer, wenn Bing keine zeigt. |
| `rawResponse` | Das HTML der Antwortseite, mit `include.rawResponse: true`. |

## So läuft ein Task

Jeder Task öffnet Bing AI Mode als neuer Besucher aus dem gewählten Land, in der Sprache dieses Landes. Bing zeigt die Antwort nur einem Teil seiner Besucher, deshalb fragt der Task als neuer Besucher bis zu achtmal innerhalb von sieben Minuten erneut und schließt mit der ersten vollständigen Antwort ab. Ein Task, dessen acht Versuche alle ohne Antwort enden, schlägt mit `ENGINE_FAILED` fehl und verbraucht keine Credits.

## Include-Flags

| Flag | Wirkung |
| - | - |
| `rawResponse` | Fügt `rawResponse` hinzu. |
| `html` | Fügt `html` hinzu, den Bildschirm, den Bing AI Mode gezeigt hat. Siehe [HTML-Seiten](https://docs.querying.ai/de/engines/html-pages.md). |

`markdown` braucht kein Flag. `ads`, `shopping` und `searchQueries` haben keine Wirkung. `analysis` wird mit `422 VALIDATION_ERROR` abgelehnt und `citationAnalysis` mit `400 VALIDATION_ERROR`. Siehe [Markdown und Rohantworten](https://docs.querying.ai/de/engines/response-options.md).

## Verwandt

* [Produktseite Bing AI Mode](https://querying.ai/de/engines/bing-ai-mode)
* [Bing Search](https://docs.querying.ai/de/engines/bing-search.md) für die bing.com-Ergebnisseite und ihre KI-Zusammenfassung
* [Microsoft Copilot](https://docs.querying.ai/de/engines/bing-copilot.md) für die Chat-Antwort von Microsoft
* [Engine-Übersicht](https://docs.querying.ai/de/engines/overview.md)


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