brave_news_search
Search for current news articles and breaking news updates using Brave's News Search API to find information on specific topics, events, or trending stories.
Instructions
This tool searches for news articles using Brave's News Search API based on the user's query. Use it when you need current news information, breaking news updates, or articles about specific topics, events, or entities.
When to use:
- Finding recent news articles on specific topics
- Getting breaking news updates
- Researching current events or trending stories
- Gathering news sources and headlines for analysis
Returns a JSON list of news-related results with title, url, and description. Some results may contain snippets of text from the article.
When relaying results in markdown-supporting environments, always cite sources with hyperlinks.
Examples:
- "According to [Reuters](https://www.reuters.com/technology/china-bans/), China bans uncertified and recalled power banks on planes".
- "The [New York Times](https://www.nytimes.com/2025/06/27/us/technology/ev-sales.html) reports that Tesla's EV sales have increased by 20%".
- "According to [BBC News](https://www.bbc.com/news/world-europe-65910000), the UK government has announced a new policy to support renewable energy".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of results (1-50, default 20) | |
| 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. | pd |
| 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) | |
| safesearch | No | Filters search results for adult content. The following values are supported: 'off' - No filtering. 'moderate' - Filter out explicit content. 'strict' - Filter out explicit and suggestive content. 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 provided query. | |
| ui_lang | No | User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110. | en-US |
Input Schema (JSON Schema)
{
"properties": {
"count": {
"default": 20,
"description": "Number of results (1-50, default 20)",
"maximum": 50,
"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.",
"type": "string"
},
"extra_snippets": {
"default": false,
"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": {
"anyOf": [
{
"const": "pd",
"type": "string"
},
{
"const": "pw",
"type": "string"
},
{
"const": "pm",
"type": "string"
},
{
"const": "py",
"type": "string"
},
{
"type": "string"
}
],
"default": "pd",
"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."
},
"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"
},
"safesearch": {
"default": "moderate",
"description": "Filters search results for adult content. The following values are supported: 'off' - No filtering. 'moderate' - Filter out explicit content. 'strict' - Filter out explicit and suggestive content. 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.",
"type": "string"
},
"spellcheck": {
"default": true,
"description": "Whether to spellcheck provided query.",
"type": "boolean"
},
"ui_lang": {
"default": "en-US",
"description": "User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}