> ## 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 Search results API

> Get Brave's own index of the web for one query: organic results, ads, FAQ, the knowledge panel, news, videos, discussions, places and related queries.

`BRAVE_SEARCH` loads Brave's results page for one query and returns its organic results, ads, FAQ, knowledge panel, news, videos, discussions, places and related queries. Brave answers from its own index and renders the page on the server, so results arrive with the page and no browser runs.

| | |
| - | - |
| `taskType` | `BRAVE_SEARCH` |
| Input | `query` or `prompt` (required), up to 600 characters and 75 words; `country`, `lang`, `safesearch`, `freshness`, `page` |
| Credits | 0.3 per task |
| Country | Defaults to `US`. Brave's markets, listed below. |
| Location | Not supported (`422 LOCATION_UNSUPPORTED`). |

## Request

```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": "how does a heat pump work in cold weather", "country": "US" } }'
```

The task runs asynchronously. Read the result as described in [Async tasks](https://docs.querying.ai/concepts/async-tasks.md).

## Parameters

| Field | Required | Description |
| - | - | - |
| `query` | Yes, or `prompt` | The search query, up to 600 characters and 75 words. |
| `prompt` | Yes, or `query` | Accepted when `query` is absent. When a request carries both, `BRAVE_SEARCH` reads `query`. |
| `country` | No | The market to search, one of `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` or `ALL`. Defaults to `US`; `ALL` searches every market. |
| `lang` | No | The language of the results, one of Brave's codes such as `en`, `ko`, `ja`, `de`, `pt-br` or `zh-hant`. Defaults to the country's language. |
| `safesearch` | No | `off`, `moderate` (default) or `strict`. |
| `freshness` | No | `pd` (past day), `pw` (past week), `pm` (past month), `py` (past year), or a range `YYYY-MM-DDtoYYYY-MM-DD`. |
| `page` | No | Results page, 1 to 10. A page holds up to 20 results, and Brave pages in small steps so neighbouring pages overlap. |

## Response

A block the page carries is included; a block it does not carry is omitted.

```json theme={"theme":"css-variables"}
{
  "organicResults": [
    { "position": 1, "title": "...", "link": "https://...", "snippet": "...", "date": "3 days ago", "siteName": "..." }
  ],
  "ads": [{ "position": 1, "title": "...", "link": "https://...", "description": "...", "displayedLink": "..." }],
  "peopleAlsoAsk": [{ "question": "...", "snippet": "...", "link": "https://..." }],
  "knowledgeGraph": { "title": "...", "description": "...", "attributes": [{ "key": "...", "value": "..." }], "profiles": ["https://..."] },
  "topStories": [{ "title": "...", "link": "https://...", "source": "...", "date": "2 days ago", "snippet": "..." }],
  "videoResults": [{ "title": "...", "link": "https://...", "source": "...", "duration": "1:02", "date": "June 16, 2026" }],
  "discussions": [{ "position": 1, "title": "...", "link": "https://...", "source": "...", "snippet": "..." }],
  "locations": [{ "position": 1, "title": "...", "link": "https://...", "address": "...", "coordinates": { "latitude": 37.5, "longitude": 127 } }],
  "relatedSearches": [{ "query": "...", "link": "https://..." }],
  "moreResultsAvailable": true,
  "page": 1
}
```

| Field | Description |
| - | - |
| `organicResults` | Always present. `position` counts from 1 on each page. `snippet` is Brave's description with its markup kept. `date` is the date the page prints in front of the snippet when it prints one, in Brave's own words. `siteName` is the publisher's name. |
| `ads` | Sponsored results, with the advertiser's landing `link` and the shown `displayedLink`. Brave places them among the organic results, which keeps their `position`. |
| `peopleAlsoAsk` | Brave's FAQ block: `question`, the answer as `snippet`, and the page it came from. |
| `knowledgeGraph` | The knowledge panel: title, description, the entity's facts as `attributes`, and its `profiles` (official pages). |
| `topStories` | News results. `date` is Brave's words ("2 days ago"). |
| `videoResults` | Videos, with `source`, `duration` and `date`. |
| `discussions` | Forum threads, with the thread's `snippet` and `source`. |
| `locations` | Places for a location query: `address`, `coordinates`, `phoneNumber`, `openingHours` and the provider's `link`. |
| `relatedSearches` | Brave's related queries, with the `link` that runs each one. |
| `moreResultsAvailable` | `true` when another page exists. |
| `page` | The page that was returned. |

Responses carry no HTML payload, so `include` has nothing to add.

## Limits and errors

* A query over 600 characters or 75 words returns `422 VALIDATION_ERROR` at submit.
* A `country` outside the list above, an unknown `lang`, a `safesearch` outside the three values, a malformed `freshness` or a `page` outside 1-10 returns `422 VALIDATION_ERROR`.
* A request Brave rate-limits answers `BRAVE_HTTP_429` after retrying on another address. `BRAVE_UNEXPECTED_PAGE` means Brave answered with a page this engine does not read, and `BRAVE_TIMEOUT` that it did not answer in time.
* Other request errors are listed in [Errors](https://docs.querying.ai/concepts/errors.md).

## Related

* [Bing Search](https://docs.querying.ai/engines/bing-search.md) for Bing's results page and its AI summary
* [Scrape](https://docs.querying.ai/engines/web-scrape.md) to read one result's whole page


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