Overview
The Brave Search node allows users to perform video searches using the Brave Search API. It is designed to query videos based on user-defined search terms and various optional parameters such as country, language preferences, safe search filtering, and freshness of results. This node is useful for automating video content discovery workflows, integrating video search capabilities into larger automation pipelines, or gathering video data for analysis.
Practical examples include:
- Searching for recent videos about a trending topic filtered by region and language.
- Automating content curation by retrieving a set number of videos matching specific keywords.
- Filtering out adult content from video search results in compliance with organizational policies.
Properties
| Name | Meaning |
|---|---|
| Query | The user's search query term. Cannot be empty. Maximum 400 characters and 50 words. |
| Count | Number of video results to return (1 to 50). Controls how many videos are retrieved per request. |
| Additional Parameters | A collection of optional parameters to refine the search: |
| - Country | Region where search results originate. Options include "All Regions", "United States", "United Kingdom", "India", "Germany", etc. |
| - Search Language | Preferred language for the search query. Examples: English, Spanish, French, Chinese Simplified, Japanese, Korean, etc. |
| - User Interface Language | Preferred language for the user interface. Examples: English (United States), Spanish (Argentina), German (Switzerland), Traditional Chinese (Taiwan), etc. |
| - Offset | Number of result sets to skip before returning results. Used for pagination. Range: 0 to 9. |
| - Spellcheck | Boolean flag to enable or disable spellchecking of the query. If enabled, the modified query is used for searching. |
| - Safe Search | Filter for adult content in results. Options: Off, Moderate, Strict. |
| - Freshness | Filter results by when they were discovered. Options: All Time, Past 24 Hours, Past 7 Days, Past Month, Past Year. |
Output
The node outputs an array of JSON objects representing the video search results returned by the Brave Search API. Each item in the output corresponds to one video result and contains metadata fields as provided by the API response. The exact structure depends on the API but typically includes video titles, URLs, thumbnails, descriptions, and other relevant video metadata.
No binary data output is indicated for this node.
Dependencies
- Requires an API key credential for authenticating requests to the Brave Search API.
- The node uses the Brave Search API endpoint
https://api.search.brave.com/res/v1for video search operations. - Proper configuration of the API key credential within n8n is necessary for successful execution.
Troubleshooting
- Empty or invalid query: The query parameter must not be empty and should respect length limits. Ensure the query string is valid and non-empty.
- API authentication errors: Verify that the API key credential is correctly configured and has the necessary permissions.
- Rate limiting or quota exceeded: The Brave Search API may limit the number of requests; handle errors gracefully and consider adding delays or retries.
- Invalid parameter values: Ensure that parameters like count, offset, country, and languages are within allowed ranges and options.
- Network issues: Check network connectivity and firewall settings if requests fail to reach the API endpoint.
Common error messages will typically relate to invalid input parameters, authentication failures, or API response errors. Reviewing the error details and adjusting inputs or credentials accordingly usually resolves these issues.