twitch/
clip

根据剪辑链接获取公开的 Twitch 剪辑,返回标题、播放量、时长、创建时间、主播资料,以及可直接下载的 MP4 文件和封面图。

Twitch Clip Downloader API

剪辑链接输入
MP4 直链
播放量
主播资料
每次请求 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

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

提交一个剪辑链接,以单行结果读取这段剪辑。

  1. 向 /v1/twitch/clip 发送 {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 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 一起存下,后续读数才能横向比较。

除了 Twitch Clip Downloader API,需要其他类型的 Twitch 公开数据时,可以使用以下 API。

探索其他平台

还可以将 Twitch 数据与其他已支持社交平台的公开数据结合使用。

Twitch Clip Downloader API — 常见问题

Twitch Clip Downloader API 是一个用于根据剪辑链接获取公开 Twitch 剪辑的 API。它返回剪辑标题、播放量、时长、创建时间、slug、主播资料,以及 MP4 直链和封面图。

每次请求提交一个剪辑链接,twitch.tv/频道/clip/slug 或 clips.twitch.tv/slug 均可;链接格式会在任务创建前校验。

可以。media 中是剪辑的 MP4 直链,地址带签名、大约一天后失效,请在任务完成后尽快下载。

标准结果保留剪辑本身、指标和主播信息。游戏名称、截取剪辑的账号以及所有可用清晰度保存在任务文件中的原始 JSONL 里。

每次请求读取一段剪辑,计 0.5 积分;找不到剪辑时任务失败并全额退款。