SuperAPI AI 工具集

videos-search

设计与创作

查看项目

更新于 10-15 17:29

技能介绍

用途:这是一个视频搜索技能,调用 Brave 视频搜索接口,按查询词返回视频结果,适合视频内容调研、新视频监控、按平台检索和视频元数据提取。

主要能力:结果含标题、URL、缩略图、时长、播放量、创作者、发布平台、标签、作者信息及页面时效等;支持时效过滤(pd 过去一天、pw 过去一周、pm 过去一月、py 过去一年或 YYYY-MM-DD 到 YYYY-MM-DD 自定义区间)、SafeSearch(off/moderate/strict)、拼写纠正、搜索运算符(如 site:youtube.com、"精确短语"、-排除词)、分页(count 1-50、offset 0-9,单次最多 50 条)。

使用方式:需 API Key,在 https://api.search.brave.com 获取,属于 Search 方案。端点 GET/POST https://api.search.brave.com/res/v1/videos/search,请求头 X-Subscription-Token: <API_KEY>,Accept: application/json。GET 示例: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}"。参数:q 必填(1-400 字符,最多 50 词),country 默认 US(两位国家码或 ALL),search_lang 默认 en,ui_lang 默认 en-US,count 默认 20,offset 默认 0,safesearch 默认 moderate,freshness 可选,spellcheck 默认 true,operators 默认 true,include_fetch_metadata 默认 false。POST 适合长查询。

适用场景:查找教程、解说与评测并按时长、播放量、创作者排序;用 freshness 跟踪新发布视频;用 site: 运算符限定 YouTube、Vimeo 等平台;提取播放量与创作者信息用于分析。需要专门视频索引和更丰富元数据时优先于网页搜索。

限制:必须提供有效 API Key 且受订阅方案约束;缺少 Key 或超出方案权限时不可用。时长字段为可变格式字符串,播放量为整数。资料未提供具体价格、配额和速率限制,暂未提供。