videos-search

Q: How do I install videos-search?

Run npx skills add https://github.com/brave/brave-search-skills --skill videos-search in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/videos-search/ (personal) or .claude/skills/videos-search/ (project).

by brave OfficialMedia & Creative

USE FOR video search. Returns videos with title, URL, thumbnail, duration, view count, creator. Supports freshness filters, SafeSearch, pagination.

Installs: 1.2K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/brave/brave-search-skills --skill videos-search

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads videos-search automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

curl -s "https://api.search.brave.com/res/v1/videos/search?q=python+tutorial" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

With Parameters

curl -s "https://api.search.brave.com/res/v1/videos/search" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  -G \
  --data-urlencode "q=machine learning explained" \
  --data-urlencode "country=US" \
  --data-urlencode "search_lang=en" \
  --data-urlencode "count=20" \
  --data-urlencode "freshness=pm"

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

FAQ

What does the videos-search skill do?

USE FOR video search. Returns videos with title, URL, thumbnail, duration, view count, creator. Supports freshness filters, SafeSearch, pagination.

How do I install videos-search?

Run npx skills add https://github.com/brave/brave-search-skills --skill videos-search in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/videos-search/ (personal) or .claude/skills/videos-search/ (project).

Which AI agents can use videos-search?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is videos-search safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains videos-search?

It is published by brave in brave/brave-search-skills, and it is an official skill from the maker of the technology it covers. It has 1,228 recorded installs.

More from brave/brave-search-skills

View all →

web-search

brave/brave-search-skills

USE FOR web search. Returns ranked results with snippets, URLs, thumbnails. Supports freshness filters, SafeSearch, Goggles for custom ranking, pagination. Primary search endpoint.

OfficialProductivity & Automation4.7K installs

images-search

brave/brave-search-skills

USE FOR image search. Returns images with title, source URL, thumbnail. Supports SafeSearch filter. Up to 200 results.

OfficialMedia & Creative1.7K installs

news-search

brave/brave-search-skills

USE FOR news search. Returns news articles with title, URL, description, age, thumbnail, profile. Supports freshness and date range filtering, SafeSearch filter and Goggles for custom ranking.

Official1.6K installs

llm-context

brave/brave-search-skills

USE FOR RAG/LLM grounding. Returns pre-extracted web content (text, tables, code) optimized for LLMs. GET + POST. Adjust maxtokens/count based on complexity. Supports Goggles, local/POI. For AI answers use answers. Recommended for anyone building AI/agentic applications.

OfficialAI & Agents1.3K installs

answers

brave/brave-search-skills

USE FOR AI-grounded answers via OpenAI-compatible /chat/completions. Two modes: single-search (fast) or deep research (enableresearch=true, thorough multi-search). Streaming/blocking. Citations.

OfficialProductivity & Automation1.2K installs

local-pois

brave/brave-search-skills

USE FOR getting local business/POI details. Requires POI IDs from local-place-search, or from web-search with resultfilter=locations. Returns full business information including ratings, hours, contact info. Max 20 IDs.

OfficialBusiness & Finance1.1K installs

Popular media & creative skills

View category →

hyperframes

heygen-com/hyperframes

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

Media & Creative1.2M installs

media-use

heygen-com/hyperframes

Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.

Media & Creative1.1M installs

hyperframes-registry

heygen-com/hyperframes

About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.

Media & Creative1M installs

hyperframes-creative

heygen-com/hyperframes

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.

Media & Creative916.5K installs

ai-video-generation

101-skills/superpowers

Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse

Media & Creative881.5K installs

ai-image-generation

101-skills/superpowers

Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image

Media & Creative880.3K installs

videos-search

Install

Install

Describe the task

Review the result

SKILL.md

Videos Search

Quick Start (cURL)

Basic Search

With Parameters

Endpoint

Parameters

Freshness Values

Response Format

Response Fields

Search Operators

Use Cases

Notes

FAQ

More from brave/brave-search-skills

Popular media & creative skills