videos-search
USE FOR video search. Returns videos with title, URL, thumbnail, duration, view count, creator. Supports freshness filters, SafeSearch, pagination.
By brave · 1,012 installs
npx skills add brave/brave-search-skills --skill videos-search
Source repository · Upstream listing
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
Quick Start (cURL)
Basic Search
With Parameters
Endpoint
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
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