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