Twitch Clip Downloader
Twitch 剪辑是观众从直播或回放里截出的精彩片段,有自己的标题、slug、播放量、时长和创建时间,并关联到原主播,同时带有渲染好的视频和封面。拿到这些信息,就能连同视频一起归档高光时刻,衡量一段剪辑传播得有多广,并在转发时准确标注来源频道。
Twitch Clip Downloader API 主要特性
- 两种剪辑链接都能用twitch.tv/频道/clip/slug 和 clips.twitch.tv/slug 两种写法指向同一段剪辑,从聊天、X 或 Discord 复制来的链接可以直接提交。
- 可播放的 MP4 与封面media 中给出剪辑的 MP4 直链和 thumbnail_url,保存或预览这段高光所需的文件都在这里。
- 播放量、时长与创建时间metrics.views_count、duration_seconds 和 published_at 分别对应剪辑的总播放量、以秒计的长度和创建时刻。
- 附带主播信息author 包含主播的 ID、登录名、显示名称、频道链接、头像和合作伙伴状态,每段剪辑都能对应到播出它的频道。
- slug 作为稳定标识shortcode 返回剪辑 slug,id 返回数字剪辑 ID,标题和播放量变化时这两个值保持不变。
Twitch Clip Downloader API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 一个公开的 Twitch 剪辑链接,格式为 https://www.twitch.tv/<channel>/clip/<slug> 或 https://clips.twitch.tv/<slug>。 |
如何使用 Twitch Clip Downloader API
提交一个剪辑链接,以单行结果读取这段剪辑。
- 向 /v1/twitch/clip 发送 {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 results.items 读取剪辑;has_more 和 results.next_cursor 遵循通用分页规则,单行结果下为空。
curl -X POST "https://api.socq.ai/v1/twitch/clip" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"}'Twitch Clip Downloader API 最佳使用场景
- 归档直播高光: 把 media 中的 MP4 与标题、主播和 published_at 一起保存,为频道建立可检索的精彩片段库。
- 追踪剪辑传播: 连续几天读取同一段剪辑,按 collected_at 绘制 metrics.views_count 的变化,判断高光是否在发酵。
- 转载时标注来源: 在剪辑进入合集、简报或社媒帖子之前,用 author 的登录名、显示名称和频道链接正确署名。
Twitch Clip Downloader API 使用建议
- 任务完成后尽快下载 MP4:media 里的地址带签名,大约一天后失效。
- 保存剪辑时以 shortcode 或 id 作为主键,而不是提交时的链接,因为同一段剪辑可能用两种链接分享。
- 每次刷新剪辑数据时,把 collected_at 与 views_count 一起存下,后续读数才能横向比较。
相关 API
除了 Twitch Clip Downloader API,需要其他类型的 Twitch 公开数据时,可以使用以下 API。
- Twitch Profile API — 通过一个公开 Twitch username 获取标准化账号记录,包含可用身份、简介、图片、账号状态、可见指标和采集上下文。
- Twitch User Videos API