Overview

Video Search lets you send queries and receive relevant video results from a dedicated index spanning various platforms and sources across the web. With continuous indexing, your applications can retrieve tutorials, entertainment, news clips, and more—all through a simple search.

Key Features

API Reference

Use Cases

Video Search is perfect for:

• Video Platforms: Build video discovery and recommendation features
• Educational Applications: Find tutorials, lectures, and instructional content
• Content Aggregation: Gather video content from across the web
• Entertainment Apps: Discover movies, shows, and entertainment content
• Media Monitoring: Track video mentions and brand coverage across platforms

Freshness Filtering

Video Search offers powerful date-based filtering to help you find the most relevant content:

• Last 24 Hours (pd): Get the latest uploaded videos
• Last 7 Days (pw): Track weekly video content
• Last 31 Days (pm): Monitor monthly uploads
• Last Year (py): Search annual video coverage
• Custom Date Range: Specify exact timeframes (e.g., 2022-04-01to2022-07-30)

Example request filtering for videos from the past week:

curl "https://api.search.brave.com/res/v1/videos/search?q=machine+learning+tutorial&freshness=pw" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

Country and Language Targeting

Customize your video search results by specifying:

• Country: Target videos from specific countries using 2-character country codes
• Search Language: Filter results by content language
• UI Language: Set the preferred language for response metadata

Example request for Spanish videos from Spain:

curl "https://api.search.brave.com/res/v1/videos/search?q=recetas+de+cocina&country=ES&search_lang=es" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

Search Operators

Video Search supports search operators to refine your queries:

• Use quotes for exact phrase matching: "python programming"
• Exclude terms with minus: cooking -vegan
• Site-specific searches: site:youtube.com fitness workout

Pagination

Efficiently paginate through video results:

• count: Number of results per page (max 50, default 20)
• offset: Page number to retrieve (0-based, max 9)

Example request for page 2 with 20 results per page:

curl "https://api.search.brave.com/res/v1/videos/search?q=travel+vlog&count=20&offset=1" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

Safe Search

Control adult content filtering with the safesearch parameter:

• off: No filtering
• moderate: Filter explicit content (default)
• strict: Filter explicit and suggestive content

This is particularly important for applications targeting family-friendly or educational audiences.

Spellcheck

Video Search includes automatic spellcheck functionality to improve search accuracy:

• Enabled by default
• Automatically corrects common misspellings
• The modified query is used for search and available in the response

To disable spellcheck:

curl "https://api.search.brave.com/res/v1/videos/search?q=tutorial&spellcheck=false" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

Example: Complete Search Request

Here’s a comprehensive example combining multiple parameters:

curl "https://api.search.brave.com/res/v1/videos/search?q=photography+tips&country=US&search_lang=en&count=25&freshness=pm&safesearch=strict" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

This request:

• Searches for “photography tips”
• Targets US content
• Returns English language results
• Retrieves 25 results
• Filters to videos from the past month
• Applies strict safe search filtering

Changelog

This changelog outlines all significant changes to the Brave Video Search API in chronological order.

• 2023-06-20 Add Brave Video Search API resource.
• 2024-02-15 Add freshness filtering with custom date ranges.
• 2024-11-05 Improve search operators support.