# Video Search

Dedicated search for videos, with advanced filtering and freshness options

## 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

### 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:

```bash
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:

```bash
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](https://search.brave.com/help/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:

```bash
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:

```bash
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:

```bash
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.