Playground

Search Brave API playground

Returns normalized web search results from Brave Search for a query string, along with offset-based pagination, related queries, discussions, videos, and the right-side knowledge.

GETapiKey3 credits/requestbrave.searchResponseDoc

Selected endpoint

GET /brave/search

Returns normalized web search results from Brave Search for a query string, along with offset-based pagination, related queries, discussions, videos, and the right-side knowledge card when Brave includes one. Use time_range for preset ranges or date_from/date_to for a custom YYYY-MM-DD range. Locale defaults to country=us and lang=en-us.

Read endpoint docs Share playground link

Group: Brave
Authentication: apiKey
Credit cost: 3 credits/request
Path parameters: 0
Query parameters: 7
Body parameters: 0

Group

Endpoint

1 endpoints in this view.

GETapiKey3 credits/requestsearchResponseDoc

Search Brave

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

API key

Active Playground key: not configured

Stored for this browser tab only when saved as the active key. Masked keys from the API key list cannot be used for calls.

Query parameters

q *

Search queryoffset

Zero-based Brave result page · min: 0country

Brave result country; defaults to uslang

Brave UI language; defaults to en-ustime_range

Preset time filter: any, day, week, month, year, or customdate_from

Custom start date in YYYY-MM-DD; requires date_todate_to

Custom end date in YYYY-MM-DD; requires date_from

Request URL will appear here.

Request headers will appear here.

Request body preview will appear here when applicable.

Status, latency, response headers, and response body will appear after a request.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "results": [
      {
        "position": 1,
        "title": "OpenAI",
        "url": "https://openai.com/",
        "description": "OpenAI helps you build and deploy AI systems.",
        "hostname": "openai.com",
        "path": "research > overview"
      }
    ],
    "pagination": {
      "offset": 0,
      "next_offset": 1
    },
    "related_queries": [
      "openai api"
    ],
    "knowledge_card": {
      "title": "OpenAI",
      "description": "AI research and deployment company",
      "long_description": "OpenAI is an AI research and deployment company building useful models and tools.",
      "url": "https://openai.com/",
      "image": "https://imgs.search.brave.com/openai-card.png",
      "category": "Artificial intelligence company"
    },
    "discussions": [
      {
        "position": 1,
        "title": "Why is OpenAI so popular?",
        "url": "https://www.reddit.com/r/OpenAI/comments/abc123/why_is_openai_so_popular/",
        "description": "Trying to understand why OpenAI has such a large audience.",
        "forum": "r/OpenAI",
        "hostname": "www.reddit.com"
      }
    ],
    "videos": [
      {
        "position": 1,
        "title": "OpenAI DevDay keynote - YouTube",
        "url": "https://www.youtube.com/watch?v=openai-devday",
        "description": "Watch the OpenAI DevDay keynote and product announcements.",
        "platform": "YouTube",
        "creator": "OpenAI"
      }
    ]
  }
}