> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Brave Search

> Access Brave's independent search index, grounded AI answers, suggestions, spellcheck, and related search products through one API.

![Brave Search logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/brave_search.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=4f03585d8920b63854ec309bc4ec3561)

* **Category:** developer tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 17
* **Triggers:** 0
* **Slug:** `BRAVE_SEARCH`
* **Version:** 00000000\_00

## Tools

> [accordion] Check Search Spelling
>
> **Slug:** `BRAVE_SEARCH_CHECK_SPELLING`
>
> Return Brave spelling corrections for a search phrase; an empty result means no correction was suggested and requires the Spellcheck product.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Search phrase to check for spelling corrections (1-400 characters and at most 50 words).
>
> **country** `string`
>
> Two-letter country code, or ALL, used to localize corrections.
>
> **language** `string`
>
> Language code used as a hint for spelling analysis.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Grounded Answer
>
> **Slug:** `BRAVE_SEARCH_GENERATE_GROUNDED_ANSWER`
>
> Generate one non-streaming web-grounded answer from a single user message using Brave Answers. The connected API key must have the separately activated Answers product.
>
> #### Input Parameters
>
> **seed** `integer`
>
> OpenAI-compatible seed accepted but currently ignored by Brave.
>
> **model** `string ("brave-pro" | "brave")`
>
> Brave Answers model; brave-pro is the higher-capability mode.
>
> **country** `string`
>
> Country code used to localize grounding searches.
>
> **language** `string`
>
> Language code for the answer and grounding searches.
>
> **metadata** `object`
>
> OpenAI-compatible metadata accepted but currently ignored by Brave.
>
> **safe\_search** `string`
>
> Brave safe-search setting for grounding retrieval.
>
> **user\_message** `string` *required*
>
> The single user question or instruction to answer with web grounding.
>
> **web\_search\_options** `object`
>
> Optional context-size and approximate-location search tuning.
>
> **max\_completion\_tokens** `integer`
>
> Maximum number of tokens Brave may generate in the answer.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Legacy Summary
>
> **Slug:** `BRAVE_SEARCH_GET_LEGACY_SUMMARY`
>
> Fetch one current poll result for a legacy Brave Summarizer key produced by web search with summary=true. This deprecated API is available only to accounts grandfathered into the discontinued Pro AI plan; new accounts cannot obtain access. Complete and failed are terminal statuses, while any other status should be retried later by calling the action again.
>
> #### Input Parameters
>
> **summary\_key** `string` *required*
>
> Key returned by a Brave web search made with summary=true. The connected API key must have the discontinued, grandfathered Pro AI entitlement.
>
> **inline\_references** `boolean`
>
> Include source references inline in the summary token stream.
>
> **include\_entity\_info** `boolean`
>
> Include entity information associated with a completed summary.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get LLM Context (GET)
>
> **Slug:** `BRAVE_SEARCH_GET_LLM_CONTEXT`
>
> Retrieve token-budgeted web snippets and source metadata for grounding or RAG using URL-friendly parameters.
>
> #### Input Parameters
>
> **count** `integer`
>
> Search recall input used during context extraction; it is not a strict count of returned grounding entries.
>
> **query** `string` *required*
>
> Question or search query whose supporting context should be extracted (1-600 characters and at most 75 words).
>
> **country** `string`
>
> Two-letter country code, or ALL for worldwide source retrieval.
>
> **goggles** `string`
>
> One Goggles URL or inline definition, or a list of at most 3 definitions used to rerank or filter source retrieval.
>
> **freshness** `string`
>
> Limit source retrieval by recency (pd, pw, pm, or py) or an inclusive YYYY-MM-DDtoYYYY-MM-DD date range.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the query.
>
> **safe\_search** `string ("off" | "moderate" | "strict")`
>
> Adult-content filtering level.
>
> **enable\_local** `boolean`
>
> Force local grounding on or off; omit to let Brave infer local recall from location headers.
>
> **location\_city** `string`
>
> Caller city used to infer local grounding.
>
> **search\_language** `string`
>
> Language code for source content.
>
> **location\_country** `string`
>
> Caller country code used to infer local grounding.
>
> **location\_latitude** `number`
>
> Caller latitude for local grounding; provide with location\_longitude.
>
> **location\_longitude** `number`
>
> Caller longitude for local grounding; provide with location\_latitude.
>
> **location\_state\_code** `string`
>
> Caller state or region code used to infer local grounding.
>
> **location\_state\_name** `string`
>
> Caller state or region name used to infer local grounding.
>
> **location\_postal\_code** `string`
>
> Caller postal code used to infer local grounding.
>
> **context\_threshold\_mode** `string ("disabled" | "strict" | "lenient" | "balanced")`
>
> Relevance threshold policy for including context.
>
> **enable\_source\_metadata** `boolean`
>
> Include expanded source metadata in the response.
>
> **maximum\_number\_of\_urls** `integer`
>
> URL extraction budget; this is not a strict cap on generic grounding entries.
>
> **maximum\_number\_of\_tokens** `integer`
>
> Overall token budget for extracted context.
>
> **maximum\_number\_of\_snippets** `integer`
>
> Overall snippet extraction budget.
>
> **maximum\_number\_of\_tokens\_per\_url** `integer`
>
> Per-source token extraction budget.
>
> **maximum\_number\_of\_snippets\_per\_url** `integer`
>
> Per-source snippet extraction budget.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get LLM Context (POST)
>
> **Slug:** `BRAVE_SEARCH_GET_LLM_CONTEXT_POST`
>
> Retrieve token-budgeted web snippets and source metadata for grounding or RAG with a JSON body, suited to complex requests.
>
> #### Input Parameters
>
> **count** `integer`
>
> Search recall input used during extraction; not a strict output-entry count.
>
> **query** `string` *required*
>
> Question or search query whose supporting context should be extracted; at most 75 words.
>
> **country** `string`
>
> Two-letter country code, or ALL for worldwide source retrieval.
>
> **goggles** `string`
>
> One Goggles definition, or a list of at most 3, used to rerank or filter source retrieval.
>
> **freshness** `string`
>
> Limit source retrieval by recency using pd, pw, pm, py, or an inclusive YYYY-MM-DDtoYYYY-MM-DD date range.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the query.
>
> **safe\_search** `string ("off" | "moderate" | "strict")`
>
> Adult-content filtering level.
>
> **enable\_local** `boolean`
>
> Force local grounding on or off; omit to use Brave's automatic behavior.
>
> **search\_language** `string`
>
> Language code for source content.
>
> **context\_threshold\_mode** `string ("disabled" | "strict" | "lenient" | "balanced")`
>
> Relevance threshold policy for including context.
>
> **enable\_source\_metadata** `boolean`
>
> Include expanded source metadata in the response.
>
> **maximum\_number\_of\_urls** `integer`
>
> URL extraction budget; not a strict cap on generic grounding entries.
>
> **maximum\_number\_of\_tokens** `integer`
>
> Overall token budget for extracted context.
>
> **maximum\_number\_of\_snippets** `integer`
>
> Overall snippet extraction budget.
>
> **maximum\_number\_of\_tokens\_per\_url** `integer`
>
> Per-source token extraction budget.
>
> **maximum\_number\_of\_snippets\_per\_url** `integer`
>
> Per-source snippet extraction budget.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Local Descriptions
>
> **Slug:** `BRAVE_SEARCH_GET_LOCAL_DESCRIPTIONS`
>
> Fetch AI-generated Markdown descriptions for up to 20 ephemeral POI IDs returned recently by place or web search.
>
> #### Input Parameters
>
> **poi\_ids** `array` *required*
>
> Ephemeral POI IDs from Search Places or a web search. IDs remain valid for about 8 hours. Each ID is sent as a repeated ids query parameter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Local POIs
>
> **Slug:** `BRAVE_SEARCH_GET_LOCAL_POIS`
>
> Fetch structured details for up to 20 ephemeral POI IDs returned recently by place or web search. Unknown or expired IDs may return null entries in the results array.
>
> #### Input Parameters
>
> **units** `string ("imperial" | "metric")`
>
> Measurement system for distances and related values.
>
> **poi\_ids** `array` *required*
>
> Ephemeral POI IDs from Search Places or a web search. IDs remain valid for about 8 hours. Each ID is sent as a repeated ids query parameter.
>
> **ui\_language** `string`
>
> Language and region code for response labels.
>
> **search\_language** `string`
>
> Language code for POI content.
>
> **location\_latitude** `number`
>
> Caller latitude for localized distance information; provide with location\_longitude.
>
> **location\_longitude** `number`
>
> Caller longitude for localized distance information; provide with location\_latitude.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Rich Result
>
> **Slug:** `BRAVE_SEARCH_GET_RICH_RESULT`
>
> Resolve a fresh callback key from a rich-enabled web search into its real-time vertical result, such as weather, finance, sports, conversions, or definitions.
>
> #### Input Parameters
>
> **callback\_key** `string` *required*
>
> Fresh callback key returned by Search Web when enable\_rich\_callback is true and a rich match exists.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Search Suggestions
>
> **Slug:** `BRAVE_SEARCH_GET_SEARCH_SUGGESTIONS`
>
> Return typo-tolerant autocomplete suggestions for a partial query, optionally with rich entity metadata; requires the Autosuggest product.
>
> #### Input Parameters
>
> **rich** `boolean`
>
> Include entity titles, descriptions, and image URLs when available; requires paid Autosuggest support for rich suggestions.
>
> **count** `integer`
>
> Maximum number of suggestions to return; Brave may return fewer.
>
> **query** `string` *required*
>
> Partial or complete query to autocomplete (1-400 characters and at most 50 words).
>
> **country** `string`
>
> Two-letter country code, or ALL, used to localize suggestions.
>
> **language** `string`
>
> Language code used as a hint when generating suggestions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Images
>
> **Slug:** `BRAVE_SEARCH_SEARCH_IMAGES`
>
> Search Brave's image index and return up to 200 image matches in one non-paginated response.
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum image results to return; this endpoint has no next page.
>
> **query** `string` *required*
>
> Image search query (1-400 characters and at most 50 words).
>
> **country** `string`
>
> Two-letter country code, or ALL for worldwide results.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the search query.
>
> **safe\_search** `string ("off" | "strict")`
>
> Adult-content filtering level.
>
> **search\_language** `string`
>
> Language code for image result context.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search News (GET)
>
> **Slug:** `BRAVE_SEARCH_SEARCH_NEWS_GET`
>
> Search Brave's news index with URL-friendly parameters and return one requested page of current news results.
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum news results on this page.
>
> **query** `string` *required*
>
> News search query. Brave accepts at most 50 words.
>
> **offset** `integer`
>
> Zero-based result page number, not an item offset.
>
> **country** `string`
>
> Two-letter country code used to localize results.
>
> **goggles** `string`
>
> One Goggle URL or inline definition, or a list of up to three, used to rerank or filter results.
>
> **freshness** `string`
>
> Limit news by recency using pd, pw, pm, py, or an inclusive YYYY-MM-DDtoYYYY-MM-DD date range.
>
> **operators** `boolean`
>
> Interpret supported Brave search operators in the query.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the search query.
>
> **safe\_search** `string ("off" | "moderate" | "strict")`
>
> Adult-content filtering level.
>
> **ui\_language** `string`
>
> Language and region code for response labels.
>
> **extra\_snippets** `boolean`
>
> Include additional snippets when available.
>
> **search\_language** `string`
>
> Language code for news content.
>
> **include\_fetch\_metadata** `boolean`
>
> Include fetch timestamps and related metadata when available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search News (POST)
>
> **Slug:** `BRAVE_SEARCH_SEARCH_NEWS_POST`
>
> Search Brave's news index with a JSON body, suited to long queries or complex Goggles, and return one requested result page.
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum number of news results on this page; the provider may return fewer.
>
> **query** `string` *required*
>
> News search query of at most 400 characters and 50 words; use POST when the complete request may exceed practical URL limits.
>
> **offset** `integer`
>
> Zero-based result page number, not an item offset.
>
> **country** `string`
>
> Two-letter supported country code used to localize results, or ALL for worldwide results.
>
> **goggles** `string`
>
> One Goggle URL or inline definition, or a list of at most three, used to rerank or filter results.
>
> **freshness** `string`
>
> Limit news by recency using pd, pw, pm, py, or an inclusive YYYY-MM-DDtoYYYY-MM-DD date range.
>
> **operators** `boolean`
>
> Interpret supported Brave search operators in the query.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the search query and search using the corrected form.
>
> **safe\_search** `string ("off" | "moderate" | "strict")`
>
> Adult-content filtering level.
>
> **ui\_language** `string`
>
> Language and region code for response labels.
>
> **extra\_snippets** `boolean`
>
> Include up to five additional alternative snippets for each result when available.
>
> **search\_language** `string`
>
> Language code for news content.
>
> **include\_fetch\_metadata** `boolean`
>
> Include provider fetch timestamps and related metadata when available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Places
>
> **Slug:** `BRAVE_SEARCH_SEARCH_PLACES`
>
> Search Brave's geographic index for POIs and named places. Returns all matching result buckets and ephemeral POI IDs for prompt follow-up with local detail and description tools.
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum combined results across all place buckets.
>
> **query** `string`
>
> Place or POI query; omit only to explore general POIs near an anchor.
>
> **units** `string ("imperial" | "metric")`
>
> Measurement system for distances and related values.
>
> **country** `string`
>
> Two-letter country code, or ALL, used to localize place results.
>
> **latitude** `number`
>
> Latitude anchor for the search area; provide with longitude.
>
> **location** `string`
>
> Named place anchor to use instead of latitude and longitude.
>
> **longitude** `number`
>
> Longitude anchor for the search area; provide with latitude.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the place query.
>
> **geolocation** `string`
>
> Coordinate string in \<latitude>x\<longitude> format used for distance calculation, for example 37.7749x-122.4194.
>
> **safe\_search** `string ("off" | "moderate" | "strict")`
>
> Adult-content filtering level.
>
> **ui\_language** `string`
>
> Language and region code for response labels.
>
> **radius\_meters** `number`
>
> Distance bias in meters, not a hard result cutoff.
>
> **search\_language** `string`
>
> Language code for place content.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Videos (GET)
>
> **Slug:** `BRAVE_SEARCH_SEARCH_VIDEOS_GET`
>
> Search Brave's video index with URL-friendly parameters and return one requested page of video results.
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum number of video results on this page; Brave may return fewer.
>
> **query** `string` *required*
>
> Video search query of at most 400 characters and 50 words.
>
> **offset** `integer`
>
> Zero-based result page number, not an item offset.
>
> **country** `string`
>
> Supported two-letter country code used to localize results, or ALL for worldwide results.
>
> **freshness** `string`
>
> Limit videos by recency using pd, pw, pm, or py, or by an inclusive YYYY-MM-DDtoYYYY-MM-DD date range.
>
> **operators** `boolean`
>
> Interpret supported Brave search operators in the query.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the query and search using the corrected form.
>
> **safe\_search** `string ("off" | "moderate" | "strict")`
>
> Adult-content filtering level.
>
> **ui\_language** `string`
>
> Language and region code for response labels.
>
> **search\_language** `string`
>
> Language code for video content.
>
> **include\_fetch\_metadata** `boolean`
>
> Include fetch timestamps and related metadata when available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Videos (POST)
>
> **Slug:** `BRAVE_SEARCH_SEARCH_VIDEOS_POST`
>
> Search Brave's video index with a JSON body, suited to long requests, and return one requested result page.
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum number of video results on this page; Brave may return fewer.
>
> **query** `string` *required*
>
> Video search query of at most 400 characters and 50 words; use POST when the request may exceed practical URL limits.
>
> **offset** `integer`
>
> Zero-based result page number, not an item offset.
>
> **country** `string`
>
> Supported two-letter country code used to localize results, or ALL for worldwide results.
>
> **freshness** `string`
>
> Limit videos by recency using pd, pw, pm, py, or an inclusive YYYY-MM-DDtoYYYY-MM-DD date range.
>
> **operators** `boolean`
>
> Interpret supported Brave search operators in the query.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the query and search using the corrected form.
>
> **safe\_search** `string ("off" | "moderate" | "strict")`
>
> Adult-content filtering level.
>
> **ui\_language** `string`
>
> Language and region code for response labels.
>
> **search\_language** `string`
>
> Language code for video content.
>
> **include\_fetch\_metadata** `boolean`
>
> Include provider fetch timestamps and related metadata when available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Web (GET)
>
> **Slug:** `BRAVE_SEARCH_SEARCH_WEB_GET`
>
> Search Brave's web index with URL-friendly parameters and return one requested result page plus any matching vertical, local, rich-callback, or legacy-summary metadata.
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum number of web results on this page; other vertical counts may differ.
>
> **query** `string` *required*
>
> Search query (1-600 characters and at most 75 words); supports Brave search operators when operators is enabled.
>
> **units** `string ("imperial" | "metric")`
>
> Measurement system for applicable rich or local results.
>
> **offset** `integer`
>
> Zero-based result page number, not an item offset.
>
> **country** `string`
>
> Two-letter country code, or ALL for worldwide results.
>
> **goggles** `string`
>
> One Goggles URL or inline definition, or a list of at most 3 definitions.
>
> **summary** `boolean`
>
> Request a legacy Summarizer key. This requires a grandfathered Pro AI entitlement and the key can be passed to the legacy summary action.
>
> **freshness** `string`
>
> Limit results by recency (pd, pw, pm, or py) or an inclusive date range formatted YYYY-MM-DDtoYYYY-MM-DD.
>
> **operators** `boolean`
>
> Interpret supported Brave search operators in the query.
>
> **goggles\_id** `string`
>
> Deprecated Goggles identifier; prefer goggles.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the search query.
>
> **user\_agent** `string`
>
> Optional caller identifier sent to Brave for this request.
>
> **api\_version** `string`
>
> Optional Brave API version header; omit to use the provider default.
>
> **safe\_search** `string ("off" | "moderate" | "strict")`
>
> Adult-content filtering level.
>
> **ui\_language** `string`
>
> Language and region code for response labels.
>
> **cache\_control** `string`
>
> Optional HTTP cache directive for this search request.
>
> **location\_city** `string`
>
> Caller city used as a local-search hint.
>
> **result\_filter** `string`
>
> Comma-separated subset of discussions, faq, infobox, news, query, summarizer, videos, web, and locations to return.
>
> **extra\_snippets** `boolean`
>
> Include additional result snippets when available.
>
> **search\_language** `string`
>
> Language code for result content.
>
> **location\_country** `string`
>
> Caller country code used as a local-search hint.
>
> **text\_decorations** `boolean`
>
> Include Brave's text decoration markup in result text.
>
> **location\_latitude** `number`
>
> Approximate caller latitude used to localize results; provide with location\_longitude.
>
> **location\_timezone** `string`
>
> IANA timezone used to localize time-sensitive results.
>
> **location\_longitude** `number`
>
> Approximate caller longitude used to localize results; provide with location\_latitude.
>
> **location\_state\_code** `string`
>
> Caller state or region code used as a local-search hint.
>
> **location\_state\_name** `string`
>
> Caller state or region name used as a local-search hint.
>
> **enable\_rich\_callback** `boolean`
>
> Return a callback key for a matching rich vertical; pass that fresh key promptly to the rich-result action.
>
> **location\_postal\_code** `string`
>
> Caller postal code used as a local-search hint.
>
> **include\_fetch\_metadata** `boolean`
>
> Include provider fetch timestamps and related metadata when available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Web (POST)
>
> **Slug:** `BRAVE_SEARCH_SEARCH_WEB_POST`
>
> Search Brave's web index with a JSON body, suited to long queries or complex Goggles, and return one requested result page plus matching vertical metadata.
>
> #### Input Parameters
>
> **count** `integer`
>
> Maximum number of web results on this page; other vertical counts may differ.
>
> **query** `string` *required*
>
> Search query (1-600 characters and at most 75 words); use this POST variant when the complete request may exceed practical URL limits.
>
> **units** `string ("imperial" | "metric")`
>
> Measurement system for applicable rich or local results.
>
> **offset** `integer`
>
> Zero-based result page number, not an item offset.
>
> **country** `string`
>
> Two-letter country code, or ALL for worldwide results.
>
> **goggles** `string`
>
> One Goggles URL or inline definition, or a list of at most 3 definitions.
>
> **summary** `boolean`
>
> Request a legacy Summarizer key. This requires a grandfathered Pro AI entitlement and the key can be passed to the legacy summary action.
>
> **freshness** `string`
>
> Limit results by recency (pd, pw, pm, or py) or an inclusive date range formatted YYYY-MM-DDtoYYYY-MM-DD.
>
> **operators** `boolean`
>
> Interpret supported Brave search operators in the query.
>
> **goggles\_id** `string`
>
> Deprecated Goggles identifier; prefer goggles.
>
> **spellcheck** `boolean`
>
> Allow Brave to correct the search query.
>
> **safe\_search** `string ("off" | "moderate" | "strict")`
>
> Adult-content filtering level.
>
> **ui\_language** `string`
>
> Language and region code for response labels.
>
> **result\_filter** `string`
>
> Comma-separated subset of discussions, faq, infobox, news, query, summarizer, videos, web, and locations to return.
>
> **extra\_snippets** `boolean`
>
> Include additional result snippets when available.
>
> **search\_language** `string`
>
> Language code for result content.
>
> **text\_decorations** `boolean`
>
> Include Brave's text decoration markup in result text.
>
> **enable\_rich\_callback** `boolean`
>
> Return a callback key for a matching rich vertical; pass that fresh key promptly to the rich-result action.
>
> **include\_fetch\_metadata** `boolean`
>
> Include provider fetch timestamps and related metadata when available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
