搜索视频
AI-generatedSummary
搜索抖音视频,根据关键词和可选过滤条件获取视频列表,并可选择下载视频到本地。
Inputs
- searchKeywords (required) — 要搜索的视频关键词
- sortType — 视频排序方式(general:综合排序,newest:最新发布,most_liked:最多点赞)
- publishTime — 视频发布时间筛选(all:不限,day:一天内,week:一周内,half_year:半年内)
- videoDuration — 视频时长筛选(all:不限,short:1分钟以下,medium:1-5分钟,long:5分钟以上)
- searchScope — 视频搜索范围(all:不限,following:关注的人,recent_viewed:最近看过,not_viewed:还未看过)
- videoCount (required) — 要爬取的视频数量(必须是4的倍数,范围 4‑100)
- downloadVideo — 是否将视频下载到本地
- downloadPath — 视频下载保存的目录路径(仅在 downloadVideo 为 true 时生效)
- options — 高级选项集合,包含以下子属性:
Output shape
每个输入项会输出一个对象,包含视频信息(标题、链接、作者等)以及 _metadata(总视频数、已下载数、失败数、执行时间、搜索关键词、过滤条件)。
若 downloadVideo 为 true,视频对象中会带有 downloaded 标志和本地文件路径;下载过程受 options 中的 videoQuality、downloadTimeout、concurrentDownloads、retryCount 等参数控制。
Examples
Example 1: 搜索 AI 智能体相关视频,获取最新 20 条并下载高清视频
searchKeywords: AI智能体, sortType: newest, videoCount: 20, downloadVideo: true, options.videoQuality: hd