brave_local_search
Search for local businesses and places using Brave's Local Search API to find detailed information including business names, addresses, ratings, phone numbers, and opening hours for location-based queries.
Instructions
Brave Local Search API provides enrichments for location search results. Access to this API is available only through the Brave Search API Pro plans; confirm the user's plan before using this tool (if the user does not have a Pro plan, use the brave_web_search tool). Searches for local businesses and places using Brave's Local Search API. Best for queries related to physical locations, businesses, restaurants, services, etc.
Returns detailed information including:
- Business names and addresses
- Ratings and review counts
- Phone numbers and opening hours
Use this when the query implies 'near me', 'in my area', or mentions specific locations (e.g., 'in San Francisco'). This tool automatically falls back to brave_web_search if no local results are found.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.) | |
| country | No | Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries. | US |
| extra_snippets | No | 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. | |
| freshness | No | 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. | |
| goggles | No | 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). | |
| offset | No | Pagination offset (max 9, default 0) | |
| query | Yes | Search query (max 400 chars, 50 words) | |
| result_filter | No | Result filter (default ['web', 'query']) | |
| safesearch | No | 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'. | moderate |
| search_lang | No | Search language preference. The 2 or more character language code for which the search results are provided. | en |
| spellcheck | No | Whether to spellcheck the provided query. | |
| summary | No | This parameter enables summary key generation in web search results. This is required for summarizer to be enabled. | |
| text_decorations | No | Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters). | |
| ui_lang | No | The language of the UI. The 2 or more character language code for which the search results are provided. | en-US |
| units | No | The measurement units. If not provided, units are derived from search country. |
Input Schema (JSON Schema)
{
"properties": {
"count": {
"default": 10,
"description": "Number of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.)",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"country": {
"default": "US",
"description": "Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries.",
"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"
},
"extra_snippets": {
"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.",
"type": "boolean"
},
"freshness": {
"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.",
"enum": [
"pd",
"pw",
"pm",
"py",
"YYYY-MM-DDtoYYYY-MM-DD"
],
"type": "string"
},
"goggles": {
"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).",
"items": {
"type": "string"
},
"type": "array"
},
"offset": {
"default": 0,
"description": "Pagination offset (max 9, default 0)",
"maximum": 9,
"minimum": 0,
"type": "integer"
},
"query": {
"description": "Search query (max 400 chars, 50 words)",
"maxLength": 400,
"type": "string"
},
"result_filter": {
"default": [
"web",
"query"
],
"description": "Result filter (default ['web', 'query'])",
"items": {
"enum": [
"discussions",
"faq",
"infobox",
"news",
"query",
"summarizer",
"videos",
"web",
"locations",
"rich"
],
"type": "string"
},
"type": "array"
},
"safesearch": {
"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'.",
"enum": [
"off",
"moderate",
"strict"
],
"type": "string"
},
"search_lang": {
"default": "en",
"description": "Search language preference. The 2 or more character language code for which the search results are provided.",
"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"
},
"spellcheck": {
"default": true,
"description": "Whether to spellcheck the provided query.",
"type": "boolean"
},
"summary": {
"description": "This parameter enables summary key generation in web search results. This is required for summarizer to be enabled.",
"type": "boolean"
},
"text_decorations": {
"default": true,
"description": "Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).",
"type": "boolean"
},
"ui_lang": {
"default": "en-US",
"description": "The language of the UI. The 2 or more character language code for which the search results are provided.",
"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"
},
"units": {
"description": "The measurement units. If not provided, units are derived from search country.",
"enum": [
"metric",
"imperial"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}