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

# Brave-Suche-Ergebnis-API

> Liefert zu einer Suche organische Treffer aus Braves eigenem Index, FAQ, Wissenspanel, Nachrichten, Videos, Diskussionen und Orte.

`BRAVE_SEARCH` öffnet mit einer Suche Braves Ergebnisseite und liefert organische Treffer, Anzeigen, FAQ, das Wissenspanel, Nachrichten, Videos, Diskussionen, Orte und verwandte Suchen. Brave antwortet aus dem eigenen Index und rendert die Seite auf dem Server, die Treffer kommen also mit der Seite und es läuft kein Browser.

| | |
| - | - |
| `taskType` | `BRAVE_SEARCH` |
| Eingabe | `query` oder `prompt` (erforderlich), höchstens 600 Zeichen und 75 Wörter; `country`, `lang`, `safesearch`, `freshness`, `page` |
| Credits | 0.3 pro Aufgabe |
| Land | Vorgabe `US`. Braves Märkte stehen unten. |
| Ort | Nicht unterstützt (`422 LOCATION_UNSUPPORTED`). |

## 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": "BRAVE_SEARCH", "payload": { "query": "wie funktioniert eine Wärmepumpe bei kaltem Wetter", "country": "DE" } }'
```

Die Aufgabe läuft asynchron. Lesen Sie das Ergebnis wie unter [Asynchrone Aufgaben](https://docs.querying.ai/de/concepts/async-tasks.md) beschrieben.

## Parameter

| Feld | Erforderlich | Beschreibung |
| - | - | - |
| `query` | Ja, oder `prompt` | Die Suche, höchstens 600 Zeichen und 75 Wörter. |
| `prompt` | Ja, oder `query` | Wird angenommen, wenn `query` fehlt. Kommen beide, liest `BRAVE_SEARCH` `query`. |
| `country` | Nein | Der Markt der Suche: `AR`, `AU`, `AT`, `BE`, `BR`, `CA`, `CL`, `DK`, `FI`, `FR`, `DE`, `GR`, `HK`, `IN`, `ID`, `IT`, `JP`, `KR`, `MY`, `MX`, `NL`, `NZ`, `NO`, `CN`, `PL`, `PT`, `PH`, `RU`, `SA`, `ZA`, `ES`, `SE`, `CH`, `TW`, `TR`, `GB`, `US` oder `ALL`. Vorgabe `US`; `ALL` sucht in allen Märkten. |
| `lang` | Nein | Die Sprache der Ergebnisse, ein Brave-Code wie `en`, `ko`, `ja`, `de`, `pt-br` oder `zh-hant`. Vorgabe ist die Sprache des Landes. |
| `safesearch` | Nein | `off`, `moderate` (Vorgabe) oder `strict`. |
| `freshness` | Nein | `pd` (letzter Tag), `pw` (letzte Woche), `pm` (letzter Monat), `py` (letztes Jahr) oder ein Bereich `YYYY-MM-DDtoYYYY-MM-DD`. |
| `page` | Nein | Ergebnisseite, 1 bis 10. Jede Seite trägt bis zu 20 Treffer; Brave geht kleine Schritte, daher überschneiden sich Nachbarseiten. |

## Antwort

Jeder Block, den die Antwort trägt, wird mitgeliefert; ein fehlender Block entfällt.

```json theme={"theme":"css-variables"}
{
  "organicResults": [
    { "position": 1, "title": "...", "link": "https://...", "snippet": "...", "date": "2026-11-13T04:00:00.000Z", "siteName": "...", "extraSnippets": ["..."] }
  ],
  "ads": [{ "position": 1, "title": "...", "link": "https://...", "description": "...", "displayedLink": "..." }],
  "peopleAlsoAsk": [{ "question": "...", "snippet": "...", "link": "https://..." }],
  "knowledgeGraph": { "title": "...", "type": "...", "description": "...", "attributes": [{ "key": "...", "value": "..." }], "profiles": ["https://..."] },
  "topStories": [{ "title": "...", "link": "https://...", "source": "...", "date": "2 days ago", "snippet": "..." }],
  "videoResults": [{ "title": "...", "link": "https://...", "platform": "...", "duration": "1:02", "views": 1234 }],
  "discussions": [{ "position": 1, "title": "...", "link": "https://...", "source": "...", "question": "...", "topComment": "..." }],
  "locations": [{ "position": 1, "title": "...", "link": "https://...", "address": "...", "coordinates": { "latitude": 37.5, "longitude": 127 } }],
  "alteredQuery": "...",
  "relatedSearches": [{ "query": "...", "link": "https://..." }],
  "moreResultsAvailable": true,
  "page": 1
}
```

| Feld | Beschreibung |
| - | - |
| `organicResults` | Immer vorhanden. `position` zählt auf jeder Seite ab 1. `snippet` ist Braves Beschreibung mit erhaltenem Markup. `date` übernimmt das Datum, das die Seite vor den Auszug druckt. `siteName` ist der Herausgebername. |
| `ads` | Anzeigen, mit der Ziel-`link` des Werbetreibenden und dem gezeigten `displayedLink`. Brave stellt sie zwischen organische Treffer, daher bleibt ihre `position`. |
| `peopleAlsoAsk` | Braves FAQ-Block: `question`, die Antwort als `snippet` und die Seite, aus der sie stammt. |
| `knowledgeGraph` | Das Wissenspanel: Titel, Kategorie, Beschreibung, die Fakten der Entität als `attributes` und ihre `profiles` (offizielle Seiten). |
| `topStories` | Nachrichten. `date` sind Braves Worte („2 days ago"). |
| `videoResults` | Videos, mit `platform`, `channel`, `duration` und `views`. |
| `discussions` | Forumsthreads, mit der `question` des Threads und seinem `topComment`, wenn Brave sie trägt. |
| `locations` | Orte einer Ortssuche: `address`, `coordinates`, `phoneNumber`, `openingHours` und der `link` des Anbieters. |
| `alteredQuery` | Vorhanden, wenn Braves Rechtschreibprüfung die Suche vorher ersetzt hat. |
| `relatedSearches` | Braves verwandte Suchen, mit dem `link`, der jede startet. |
| `moreResultsAvailable` | `true`, wenn es Treffer jenseits dieser Seite gibt. |
| `page` | Die gelieferte Seite. |

Kein HTML-Payload, `include` fügt also nichts hinzu.

Die API-Bedingungen von Brave beschränken das Speichern von API-Ergebnissen über den App-Betrieb hinaus. Nun wird die Seite gelesen, der Geltungsbereich ist ein anderer, und vor langem Aufbewahren ist Braves Antwort nötig.

## Grenzen und Fehler

* Eine Suche mit mehr als 600 Zeichen oder 75 Wörtern antwortet beim Absenden mit `422 VALIDATION_ERROR`.
* Ein `country` außerhalb der Liste, ein unbekannter `lang`, ein `safesearch` außerhalb der drei Werte, ein falsch geformter `freshness` oder eine `page` außerhalb 1–10 ergeben `422 VALIDATION_ERROR`.
* Eine von Brave gedrosselte Anfrage antwortet nach einem neuen Versuch über eine andere Adresse mit `BRAVE_HTTP_429`. `BRAVE_UNEXPECTED_PAGE` heißt: Brave antwortete mit einer Seite, die dieser Motor nicht liest, `BRAVE_TIMEOUT`: keine Antwort rechtzeitig.
* Weitere Anfragefehler stehen unter [Fehler](https://docs.querying.ai/de/concepts/errors.md).

## Verwandt

* [Bing Search](https://docs.querying.ai/de/engines/bing-search.md) für Bings Ergebnisseite und deren KI-Zusammenfassung
* [Scrape](https://docs.querying.ai/de/engines/web-scrape.md), um die ganze Seite eines Treffers zu lesen


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