| query.cleaned | string? | Cleaned/normalized query | | query.spellcheck_off | bool? | Whether spellcheck was disabled | | query.more_results_available | bool | Whether more pages exist | | query.show_strict_warning | bool? | True if strict safesearch blocked adult results | | query.search_operators | object? | Applied search operators (applied, cleaned_query, sites) | | web.type | string | Always "search" | | web.results[].title | string | Page title | | web.results[].url | string | Page URL | | web.results[].description | string? | Snippet/description text | | web.results[].age | string? | Human-readable age (e.g., "2 days ago") | | web.results[].language | string? | Content language code | | web.results[].meta_url | object | URL components (scheme, netloc, hostname, path) | | web.results[].thumbnail | object? | Thumbnail (src, original) | | web.results[].thumbnail.original | string? | Original full-size image URL | | web.results[].thumbnail.logo | bool? | Whether the thumbnail is a logo | | web.results[].profile | object? | Publisher identity (name, url, long_name, img) | | web.results[].page_age | string? | ISO datetime of publication (e.g., "2025-04-12T14:22:41") | | web.results[].extra_snippets | list[str]? | Up to 5 additional excerpts | | web.results[].deep_results | object? | Additional links (buttons, links) from the page | | web.results[].schemas | list? | Raw schema.org structured data | | web.results[].product | object? | Product info and reviews | | web.results[].recipe | object? | Recipe details (ingredients, time, ratings) | | web.results[].article | object? | Article metadata (author, publisher, date) | | web.results[].book | object? | Book info (author, ISBN, rating) | | web.results[].software | object? | Software product info | | web.results[].rating | object? | Aggregate ratings | | web.results[].faq | object? | FAQ found on the page | | web.results[].movie | object? | Movie info (directors, actors, genre) | | web.results[].video | object? | Video metadata (duration, views, creator) | | web.results[].location | object? | Location/restaurant details | | web.results[].qa | object? | Question/answer info | | web.results[].creative_work | object? | Creative work data | | web.results[].music_recording | object? | Music/song data | | web.results[].organization | object? | Organization info | | web.results[].review | object? | Review data | | web.results[].content_type | string? | Content type classification | | web.results[].fetched_content_timestamp | int? | Fetch timestamp (with include_fetch_metadata=true) | | web.mutated_by_goggles | bool | Whether results were re-ranked by Goggles | | web.family_friendly | bool | Whether results are family-friendly | | mixed | object? | Preferred display order (see Mixed Response below) | | discussions.results[] | array? | Forum discussion clusters | | discussions.results[].data.forum_name | string? | Forum/community name | | discussions.results[].data.num_answers | int? | Number of answers/replies | | discussions.results[].data.question | string? | Discussion question | | discussions.results[].data.top_comment | string? | Top-voted comment excerpt | | faq.results[] | array? | FAQ entries | | news.results[] | array? | News articles | | videos.results[] | array? | Video results | | infobox.results[] | array? | Knowledge graph entries | | locations.results[] | array? | Local POI results | | rich.hint.vertical | string? | Rich result type | | rich.hint.callback_key | string? | Callback key for rich data |

JSON Example

{
  "type": "search",
  "query": {
    "original": "python frameworks",
    "altered": "python web frameworks",
    "spellcheck_off": false,
    "more_results_available": true
  },
  "web": {
    "type": "search",
    "results": [
      {
        "title": "Top Python Web Frameworks",
        "url": "https://example.com/python-frameworks",
        "description": "A comprehensive guide to Python web frameworks...",
        "age": "2 days ago",
        "language": "en",
        "meta_url": {
          "scheme": "https",
          "netloc": "example.com",
          "hostname": "example.com",
          "path": "/python-frameworks"
        },
        "thumbnail": {
          "src": "https://...",
          "original": "https://original-image-url.com/img.jpg"
        },
        "extra_snippets": ["Additional excerpt 1...", "Additional excerpt 2..."]
      }
    ],
    "family_friendly": true
  },
  "mixed": {
    "type": "mixed",
    "main": [
      {"type": "web", "index": 0, "all": false},
      {"type": "web", "index": 1, "all": false},
      {"type": "videos", "all": true}
    ],
    "top": [],
    "side": []
  },
  "videos": { "...": "..." },
  "news": { "...": "..." },
  "rich": {
    "type": "rich",
    "hint": {
      "vertical": "weather",
      "callback_key": "<callback_key_hex>"
    }
  }
}

Mixed Response

The mixed object defines the preferred display order of results across types. It contains three arrays:

Each entry is a ResultReference with type (e.g., "web", "videos"), index (into the corresponding result array), and all (true to include all results of that type at this position).

Search Operators

Set operators=false to disable operator parsing.

Goggles (Custom Ranking) — Unique to Brave

Goggles let you re-rank search results — boost trusted sources, suppress SEO spam, or build focused search scopes.

Hosted goggles must be on GitHub/GitLab, include ! name:, ! description:, ! author: headers, and be registered at https://search.brave.com/goggles/create. Inline rules need no registration.

Syntax: Rules start with $ + comma-separated options. Actions (pick one): discard, boost[=N], downrank[=N] — N is an integer 1–10. Site filter: site=DOMAIN. Example: $site=example.com,boost=3. Separate rules with \n (%0A).

Allow list: $discard\n$site=docs.python.org\n$site=developer.mozilla.org — Block list: $discard,site=pinterest.com\n$discard,site=quora.com

Resources: Discover · Syntax · Quickstart

Rich Data Enrichments

For queries about weather, stocks, sports, currency, etc., use the rich callback workflow:

# 1. Search with rich callback enabled
curl -s "https://api.search.brave.com/res/v1/web/search?q=weather+san+francisco&enable_rich_callback=true" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

# Response includes: "rich": {"hint": {"callback_key": "abc123...", "vertical": "weather"}}

# 2. Get rich data with the callback key
curl -s "https://api.search.brave.com/res/v1/web/rich?callback_key=abc123..." \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

Supported Rich Types: Calculator, Definitions, Unit Conversion, Unix Timestamp, Package Tracker, Stock, Currency, Cryptocurrency, Weather, American Football, Baseball, Basketball, Cricket, Football/Soccer, Ice Hockey, Web3, Translator

Rich Callback Endpoint

GET https://api.search.brave.com/res/v1/web/rich

Use Cases

• General-purpose search integration: Richest result set (web, news, videos, discussions, FAQ, infobox, locations) in one call. For RAG/LLM grounding, prefer llm-context.
• Structured data extraction: Products, recipes, ratings, articles via schemas and typed fields on results.
• Custom search with Goggles: Unique to Brave. Boost/discard sites with inline rules or hosted Goggles for fully customized ranking.

Notes

• Pagination: Use offset (0-9) with count to page through results
• Count: Max 20 for web search; actual results may be less than requested