videos-search

by brave

USE FOR video search. Returns videos with title, URL, thumbnail, duration, view count, creator. Supports freshness filters, SafeSearch, pagination. npx skills add https://github.com/brave/brave-search-skills --skill videos-search Download ZIPGitHub158

Videos Search

Requires API Key: Get one at https://api.search.brave.com

Plan: Included in the Search plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe

Endpoint

GET https://api.search.brave.com/res/v1/videos/search
POST https://api.search.brave.com/res/v1/videos/search

Authentication: X-Subscription-Token: <API_KEY> header

Note: Both GET and POST methods are supported. POST is useful for long queries.

Parameters

Parameter Type Required Default Description q string Yes - Search query (1-400 chars, max 50 words) country string No US Search country (2-letter country code or ALL) search_lang string No en Language preference (2+ char language code) ui_lang string No en-US UI language (e.g., "en-US") count int No 20 Number of results (1-50) offset int No 0 Page offset (0-9) safesearch string No moderate Adult content filter (off/moderate/strict) freshness string No - Time filter (pd/pw/pm/py or date range) spellcheck bool No true Auto-correct query operators bool No true Apply search operators include_fetch_metadata bool No false Include fetched_content_timestamp in results

Freshness Values

Value Description pd Past day (24 hours) pw Past week (7 days) pm Past month (31 days) py Past year (365 days) YYYY-MM-DDtoYYYY-MM-DD Custom date range

Response Format

{
 "type": "videos",
 "query": {
 "original": "python tutorial",
 "spellcheck_off": false
 },
 "extra": {
 "might_be_offensive": false
 },
 "results": [
 {
 "type": "video_result",
 "title": "Python Tutorial for Beginners",
 "url": "https://www.youtube.com/watch?v=rfscVS0vtbw",
 "description": "Learn Python programming from scratch...",
 "age": "February 12, 2025",
 "page_age": "2025-02-12T00:00:00",
 "page_fetched": "2025-02-12T15:00:00Z",
 "thumbnail": {
 "src": "https://imgs.search.brave.com/...",
 "original": "https://i.ytimg.com/vi/rfscVS0vtbw/hqdefault.jpg"
 },
 "video": {
 "duration": "03:45:00",
 "views": 1523000,
 "creator": "freeCodeCamp",
 "publisher": "YouTube",
 "requires_subscription": false,
 "tags": ["python", "programming"],
 "author": {
 "name": "freeCodeCamp.org",
 "url": "https://www.youtube.com/@freecodecamp"
 }
 },
 "meta_url": {
 "scheme": "https",
 "netloc": "youtube.com",
 "hostname": "www.youtube.com",
 "favicon": "https://imgs.search.brave.com/...",
 "path": "\u203a watch"
 }
 }
 ]
}

Response Fields

Field Type Description type string Always "videos" query.original string The original search query query.altered string? Spellcheck-corrected query (if changed) query.cleaned string? Cleaned/normalized query query.spellcheck_off bool? Whether spellcheck was disabled query.show_strict_warning bool? True if strict safesearch blocked adult results query.search_operators object? Applied search operators (applied, cleaned_query, sites) extra.might_be_offensive bool Whether results may contain offensive content results[].type string Always "video_result" results[].url string Source URL of the video results[].title string Video title results[].description string? Video description results[].age string? Human-readable age (e.g. "6 months ago") or absolute date (e.g. "February 12, 2025") results[].page_age string? Page age from source (ISO datetime) results[].page_fetched string? ISO datetime when page was last fetched (e.g. 2025-02-12T15:00:00Z) results[].fetched_content_timestamp int? Fetch timestamp (only with include_fetch_metadata=true) results[].video.duration string? Time string (variable format) results[].video.views int? View count as integer results[].video.creator string? Channel/creator name results[].video.publisher string? Platform (YouTube, Vimeo, etc.) results[].video.requires_subscription bool? Whether video requires a subscription results[].video.tags list[str]? Tags relevant to the video results[].video.author object? Author profile results[].video.author.name string Author name results[].video.author.url string Author profile URL results[].video.author.long_name string? Extended author name results[].video.author.img string? Author profile image URL results[].thumbnail.src string Served thumbnail URL results[].thumbnail.original string? Original thumbnail URL results[].meta_url.scheme string? URL protocol scheme results[].meta_url.netloc string? Network location results[].meta_url.hostname string? Lowercased domain name results[].meta_url.favicon string? Favicon URL results[].meta_url.path string? URL path

Search Operators

Use search operators to refine results:

• site:youtube.com - Limit to specific site

• "exact phrase" - Match exact phrase

• -exclude - Exclude term

Set operators=false to disable operator parsing.

Use Cases

• Video content research: Find tutorials, explainers, and reviews by topic. Use the video.duration, video.views, and video.creator metadata to filter and rank results programmatically. Prefer videos-search over web-search when you need a dedicated video index with richer metadata (duration, views, creator, tags) and up to 50 results per request.

• Fresh video monitoring: Use freshness=pd or freshness=pw to track newly published video content on trending topics or specific subjects.

• Platform-specific search: Use site:youtube.com or site:vimeo.com operators to target specific video platforms.

• Video metadata extraction: Get view counts, durations, creator info, and tags for analytics, content curation, or recommendation systems.

Notes

• Pagination: Use offset (0-9) with count for more results

• Max results: Up to 50 results per request