Brave Search 视频搜索 API：快速集成视频搜索功能，支持多参数过滤

videos-search by brave/brave-search-skills

134 周安装量

95 GitHub Stars

GitHub

安装命令

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

内容创作 API 搜索

🇨🇳中文介绍

视频搜索

需要 API 密钥 : 在 https://api.search.brave.com 获取

套餐 : 包含在搜索套餐中。参见 https://api-dashboard.search.brave.com/app/subscriptions/subscribe

快速开始 (cURL)

基础搜索

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}"

带参数搜索

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"

端点

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

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

SoulTrace 人格评估 API - 基于五色心理模型的贝叶斯自适应测试

50,400 周安装

README 国际化工具：自动化翻译与多语言文档管理 | readme-i18n

46,000 周安装

Lark Skill Maker 教程：基于飞书CLI创建AI技能，自动化工作流与API调用指南

39,100 周安装

认证 : X-Subscription-Token: <API_KEY> 请求头

注意 : 同时支持 GET 和 POST 方法。POST 方法适用于较长的查询。

参数	类型	必填	默认值	描述
`q`	string	是	-	搜索查询 (1-400 字符，最多 50 个单词)
`country`	string	否	`US`	搜索国家 (2 字母国家代码或 `ALL`)
`search_lang`	string	否	`en`	语言偏好 (2+ 字符语言代码)
`ui_lang`	string	否	`en-US`	UI 语言 (例如 "en-US")
`count`	int	否	`20`	结果数量 (1-50)
`offset`	int	否	`0`	分页偏移量 (0-9)
`safesearch`	string	否	`moderate`	成人内容过滤器 (`off`/`moderate`/`strict`)
`freshness`	string	否	-	时间过滤器 (`pd`/`pw`/`pm`/`py` 或日期范围)
`spellcheck`	bool	否	`true`	自动纠正查询
`operators`	bool	否	`true`	应用搜索运算符
`include_fetch_metadata`	bool	否	`false`	在结果中包含 `fetched_content_timestamp`

值	描述
`pd`	过去一天 (24 小时)
`pw`	过去一周 (7 天)
`pm`	过去一个月 (31 天)
`py`	过去一年 (365 天)
`YYYY-MM-DDtoYYYY-MM-DD`	自定义日期范围

{
  "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"
      }
    }
  ]
}

字段	类型	描述
`type`	string	始终为 `"videos"`
`query.original`	string	原始搜索查询
`query.altered`	string?	拼写检查纠正后的查询 (如果已更改)
`query.cleaned`	string?	清理/规范化后的查询
`query.spellcheck_off`	bool?	拼写检查是否被禁用
`query.show_strict_warning`	bool?	如果严格安全搜索阻止了成人结果，则为 true
`query.search_operators`	object?	应用的搜索运算符 (`applied`, `cleaned_query`, `sites`)
`extra.might_be_offensive`	bool	结果是否可能包含冒犯性内容
`results[].type`	string	始终为 `"video_result"`
`results[].url`	string	视频的源 URL
`results[].title`	string	视频标题
`results[].description`	string?	视频描述
`results[].age`	string?	人类可读的发布时间 (例如 "6 months ago") 或绝对日期 (例如 "February 12, 2025")
`results[].page_age`	string?	来源页面的发布时间 (ISO 日期时间)
`results[].page_fetched`	string?	页面最后抓取时的 ISO 日期时间 (例如 `2025-02-12T15:00:00Z`)
`results[].fetched_content_timestamp`	int?	抓取时间戳 (仅在 `include_fetch_metadata=true` 时存在)
`results[].video.duration`	string?	时长字符串 (可变格式)
`results[].video.views`	int?	观看次数 (整数)
`results[].video.creator`	string?	频道/创作者名称
`results[].video.publisher`	string?	平台 (YouTube, Vimeo 等)
`results[].video.requires_subscription`	bool?	视频是否需要订阅
`results[].video.tags`	list[str]?	与视频相关的标签
`results[].video.author`	object?	作者信息
`results[].video.author.name`	string	作者名称
`results[].video.author.url`	string	作者个人资料 URL
`results[].video.author.long_name`	string?	扩展的作者名称
`results[].video.author.img`	string?	作者个人资料图片 URL
`results[].thumbnail.src`	string	提供的缩略图 URL
`results[].thumbnail.original`	string?	原始缩略图 URL
`results[].meta_url.scheme`	string?	URL 协议方案
`results[].meta_url.netloc`	string?	网络位置
`results[].meta_url.hostname`	string?	小写的域名
`results[].meta_url.favicon`	string?	网站图标 URL
`results[].meta_url.path`	string?	URL 路径

使用搜索运算符来优化结果：

site:youtube.com - 限制到特定网站
"exact phrase" - 匹配精确短语
-exclude - 排除术语

设置 operators=false 以禁用运算符解析。

视频内容研究 : 按主题查找教程、讲解和评测。使用 video.duration、video.views 和 video.creator 元数据以编程方式过滤和排序结果。当您需要一个专用的视频索引，包含更丰富的元数据 (时长、观看次数、创作者、标签) 并且每个请求最多支持 50 个结果时，优先选择视频搜索而非网页搜索。
新鲜视频监控 : 使用 freshness=pd 或 freshness=pw 来跟踪热门话题或特定主题上新发布的视频内容。
平台特定搜索 : 使用 site:youtube.com 或 site:vimeo.com 运算符来定位特定的视频平台。
视频元数据提取 : 获取观看次数、时长、创作者信息和标签，用于分析、内容策划或推荐系统。

分页 : 结合使用 offset (0-9) 和 count 来获取更多结果
最大结果数 : 每个请求最多 50 个结果

🇺🇸English

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

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`

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

Weekly Installs

Repository

brave/brave-sea…h-skills

GitHub Stars

First Seen

Feb 14, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

gemini-cli30

codex30

opencode29

github-copilot29

kimi-cli29

amp28

Lark CLI Wiki API 使用指南：获取知识空间节点信息与权限管理