模板代码:youtube_search
当前版本: v6
功能简介 #
根据关键词获取 YouTube 搜索结果,可按上传时间、相关度或其他排序选项筛选,也可设置视频功能条件。适用于热点跟踪、视频内容研究和频道发现。
使用方法 #
在 Clawoxy 控制台打开 Scraping API,从模板市场选择 YouTube 搜索采集器,在“采集调试”填写参数并选择同步或异步模式。
也可以通过代码调用:在自己的程序中请求 Scraping API,传入本模板代码和输入参数,并按所选同步或异步模式处理结果。
如果不确定如何编写代码,可以把目标网站链接和本模板说明提供给 AI,请 AI 根据模板支持的输入参数和 Scraping API 接口要求生成调用代码。使用前请核对参数、API Key 处理方式及结果解析逻辑。
输入参数 #
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索词,1–2048 字符。 |
| upload_date | string | 否 | 按上传时间筛选,选项见控制台。 |
| sort_by | string | 否 | 排序方式,默认相关度。 |
| features | array | 否 | 最多选 11 项:直播、4K、高清、字幕、知识共享、360°、VR180、3D、HDR、地点、已购买。 |
输出内容 #
| 字段 | 类型 | 说明 |
|---|---|---|
| url | string | 视频链接 |
| title | string | 视频标题 |
| video_id | string | 视频 ID |
| description | string | 视频简介 |
| badges | 字符串数组 | 视频标记列表 |
| is_live | boolean | 是否为直播 |
| position | integer | 搜索结果位置 |
| channel_id | string | 频道 ID |
| channel_url | string | 频道页面链接 |
| channel_name | string | 频道名称 |
| duration_text | string | 视频时长文本 |
| duration_seconds | integer | 视频时长秒数 |
| thumbnail_url | string | 缩略图链接 |
| view_count_text | string | 页面显示的播放量原文 |
| published_at_text | string | 页面显示的发布时间原文 |
| concurrent_viewers_text | string | 直播同时观看人数原文 |
示例返回 #
空字段、0、false 是结构占位,不代表实际搜索结果。
[{"url":"","title":"","badges":[""],"is_live":false,"position":0,"video_id":"","channel_id":"","channel_url":"","description":"","channel_name":"","duration_text":"","thumbnail_url":"","view_count_text":"","duration_seconds":0,"published_at_text":"","concurrent_viewers_text":""}]
采集结果保留 3 天。