Skip to main content

​
Overview

Video Search provides access to a dedicated index of video content from various platforms and sources across the web. Our service indexes video content continuously, enabling you to retrieve relevant videos, tutorials, entertainment content, and more for your applications.

​
Key Features

Video-Specific Index

Search across a curated index of video content from multiple platforms and sources

Freshness Filtering

Filter results by discovery date - from last 24 hours to custom date ranges

Country & Language Options

Target videos from specific countries and in preferred languages

Safe Search Filtering

Control adult content filtering with flexible options

​
API Reference

Video Search API Documentation

View the complete API reference, including endpoints, parameters, and example requests

​
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 -s --compressed "https://api.search.brave.com/res/v1/videos/search?q=machine+learning+tutorial&freshness=pw" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -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 -s --compressed "https://api.search.brave.com/res/v1/videos/search?q=recetas+de+cocina&country=ES&search_lang=es" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -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 -s --compressed "https://api.search.brave.com/res/v1/videos/search?q=travel+vlog&count=20&offset=1" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"
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 -s --compressed "https://api.search.brave.com/res/v1/videos/search?q=tutorial&spellcheck=false" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

​
Example: Complete Search Request

Here’s a comprehensive example combining multiple parameters: 
curl -s --compressed "https://api.search.brave.com/res/v1/videos/search?q=photography+tips&country=US&search_lang=en&count=25&freshness=pm&safesearch=strict" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -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.
⌘I