Brave Search
brave_web_search
Performs web searches using the Brave Search API and returns comprehensive search results with rich metadata. When to use: - General web searches for information, facts, or current topics - Location-based queries (restaurants, businesses, points of interest) - News searches for recent events or breaking stories - Finding videos, discussions, or FAQ content - Research requiring diverse result types (web pages, images, reviews, etc.) Returns a JSON list of web results with title, description, and URL. When the "results_filter" parameter is empty, JSON results may also contain FAQ, Discussions, News, and Video results.
Other tools also called brave_web_search?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Number of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.)"
},
"query": {
"type": "string",
"maxLength": 400,
"description": "Search query (max 400 chars, 50 words)"
},
"units": {
"enum": [
"metric",
"imperial"
],
"type": "string",
"description": "The measurement units. If not provided, units are derived from search country."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9,
"minimum": 0,
"description": "Pagination offset (max 9, default 0)"
},
"country": {
"enum": [
"ALL",
"AR",
"AU",
"AT",
"BE",
"BR",
"CA",
"CL",
"DK",
"FI",
"FR",
"DE",
"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"
],
"type": "string",
"default": "US",
"description": "Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries."
},
"goggles": {
"type": "array",
"items": {
"type": "string"
},
"description": "Goggles act as a custom re-ranking on top of Brave's search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, refer to the Goggles repository (i.e., https://github.com/brave/goggles-quickstart)."
},
"summary": {
"type": "boolean",
"description": "This parameter enables summary key generation in web search results. This is required for summarizer to be enabled."
},
"ui_lang": {
"enum": [
"es-AR",
"en-AU",
"de-AT",
"nl-BE",
"fr-BE",
"pt-BR",
"en-CA",
"fr-CA",
"es-CL",
"da-DK",
"fi-FI",
"fr-FR",
"de-DE",
"zh-HK",
"en-IN",
"en-ID",
"it-IT",
"ja-JP",
"ko-KR",
"en-MY",
"es-MX",
"nl-NL",
"en-NZ",
"no-NO",
"zh-CN",
"pl-PL",
"en-PH",
"ru-RU",
"en-ZA",
"es-ES",
"sv-SE",
"fr-CH",
"de-CH",
"zh-TW",
"tr-TR",
"en-GB",
"en-US",
"es-US"
],
"type": "string",
"default": "en-US",
"description": "The language of the UI. The 2 or more character language code for which the search results are provided."
},
"freshness": {
"enum": [
"pd",
"pw",
"pm",
"py",
"YYYY-MM-DDtoYYYY-MM-DD"
],
"type": "string",
"description": "Filters search results by when they were discovered. The following values are supported: 'pd' - Discovered within the last 24 hours. 'pw' - Discovered within the last 7 days. 'pm' - Discovered within the last 31 days. 'py' - Discovered within the last 365 days. 'YYYY-MM-DDtoYYYY-MM-DD' - Timeframe is also supported by specifying the date range e.g. 2022-04-01to2022-07-30."
},
"safesearch": {
"enum": [
"off",
"moderate",
"strict"
],
"type": "string",
"default": "moderate",
"description": "Filters search results for adult content. The following values are supported: 'off' - No filtering. 'moderate' - Filters explicit content (e.g., images and videos), but allows adult domains in search results. 'strict' - Drops all adult content from search results. The default value is 'moderate'."
},
"spellcheck": {
"type": "boolean",
"default": true,
"description": "Whether to spellcheck the provided query."
},
"search_lang": {
"enum": [
"ar",
"eu",
"bn",
"bg",
"ca",
"zh-hans",
"zh-hant",
"hr",
"cs",
"da",
"nl",
"en",
"en-gb",
"et",
"fi",
"fr",
"gl",
"de",
"gu",
"he",
"hi",
"hu",
"is",
"it",
"jp",
"kn",
"ko",
"lv",
"lt",
"ms",
"ml",
"mr",
"nb",
"pl",
"pt-br",
"pt-pt",
"pa",
"ro",
"ru",
"sr",
"sk",
"sl",
"es",
"sv",
"ta",
"te",
"th",
"tr",
"uk",
"vi"
],
"type": "string",
"default": "en",
"description": "Search language preference. The 2 or more character language code for which the search results are provided."
},
"result_filter": {
"type": "array",
"items": {
"enum": [
"discussions",
"faq",
"infobox",
"news",
"query",
"summarizer",
"videos",
"web",
"locations",
"rich"
],
"type": "string"
},
"default": [
"web",
"query"
],
"description": "Result filter (default ['web', 'query'])"
},
"extra_snippets": {
"type": "boolean",
"description": "A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts. Only available under Free AI, Base AI, Pro AI, Base Data, Pro Data and Custom plans."
},
"text_decorations": {
"type": "boolean",
"default": true,
"description": "Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters)."
}
}
}