Brave Search

summarizer

API for AI-generated answers backed by real-time web search and verifiable sources

Request Body required

messages object[] required

model enum<string>

Available options: brave-probrave

max_completion_tokens integer nullable

metadata object nullable

seed integer nullable

stream boolean

web_search_options object nullable

country string

language string

safesearch string

enable_entities boolean

enable_citations boolean

enable_research boolean

research_allow_thinking boolean

research_maximum_number_of_tokens_per_query integer

research_maximum_number_of_queries integer

research_maximum_number_of_iterations integer

research_maximum_number_of_seconds integer

research_maximum_number_of_results_per_query integer

Responses

200 Successful Response

model enum<string>

Available options: brave-probrave

system_fingerprint string nullable

choices object[] required

created integer required

id string required

object "chat.completion.chunk"

usage object nullable

400 Bad Request

type string

error object required

time integer

402 Payment Required

type string

error object required

time integer

403 Forbidden

type string

error object required

time integer

404 Not Found

type string

error object required

time integer

422 Unprocessable Entity

type string

error object required

time integer

429 Too Many Requests

type string

error object required

time integer

curl -X POST -s --compressed "https://api.search.brave.com/res/v1/chat/completions" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "Content-Type: application/json" \
  -d '{"stream": false, "messages": [{"role": "user", "content": "What is the second highest mountain?"}]}' \
  -H "x-subscription-token: <YOUR_BRAVE_SEARCH_API_KEY>"

from openai import AsyncOpenAI
import asyncio

client = AsyncOpenAI(
    api_key="<YOUR_BRAVE_SEARCH_API_KEY>",
    base_url="https://api.search.brave.com/res/v1",
)

async def stream_answer():
    async for chunk in await client.chat.completions.create(
        messages=[
            {
                "role": "user",
                "content": "Explain quantum computing",
            }
        ],
        model="brave",
        stream=True,
    ):
        if chunk.choices[0].delta.content:
            print(chunk.choices[0].delta.content, end="", flush=True)

asyncio.run(stream_answer())