brave_video_search
Search for videos using Brave's API to find content by topic, keyword, or creator with metadata like title, duration, and thumbnail.
Instructions
Searches for videos using Brave's Video Search API and returns structured video results with metadata.
When to use:
- When you need to find videos related to a specific topic, keyword, or query.
- Useful for discovering video content, getting video metadata, or finding videos from specific creators/publishers.
Returns a JSON list of video-related results with title, url, description, duration, and thumbnail_url.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of results (1-50, default 20). Combine this parameter with `offset` to paginate search results. | |
| country | No | Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries. | US |
| 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'). | |
| offset | No | Pagination offset (max 9, default 0). Combine this parameter with `count` to paginate search results. | |
| query | Yes | The user's search query. Query cannot be empty. Limited to 400 characters and 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). Combine this parameter with `offset` to paginate search results.",
"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"
},
"freshness": {
"anyOf": [
{
"const": "pd",
"type": "string"
},
{
"const": "pw",
"type": "string"
},
{
"const": "pm",
"type": "string"
},
{
"const": "py",
"type": "string"
},
{
"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')."
},
"offset": {
"default": 0,
"description": "Pagination offset (max 9, default 0). Combine this parameter with `count` to paginate search results.",
"maximum": 9,
"minimum": 0,
"type": "integer"
},
"query": {
"description": "The user's search query. Query cannot be empty. Limited to 400 characters and 50 words.",
"maxLength": 400,
"minLength": 1,
"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"
}