twitch/
clip

公開されているTwitchクリップをクリップURLから取得し、タイトル、再生数、長さ、作成日時、配信者プロフィール、そして直接ダウンロードできるMP4とサムネイルを返します。

Twitch Clip Downloader API

クリップURL入力
MP4直リンク
再生数
配信者プロフィール
1リクエストあたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Twitch Clip Downloader

Twitchクリップは、視聴者がライブ配信やアーカイブから切り出した短いハイライトで、タイトル、slug、再生数、長さ、作成日時、元の配信者、そして書き出し済みの動画とサムネイルを持っています。これらの情報があれば、名場面を動画ごと保存したり、クリップがどこまで広がったかを測ったり、転載時に正しいチャンネルを明記したりできます。

Twitch Clip Downloader API の主な機能

  • 2種類のクリップURLに対応twitch.tv/チャンネル/clip/slug 形式と clips.twitch.tv/slug 形式のどちらも同じクリップとして扱うため、チャットやX、Discordからコピーしたリンクをそのまま送れます。
  • 再生できるMP4とサムネイルmedia にはクリップのMP4直リンクと thumbnail_url が入り、保存やプレビューに必要なファイルがそろいます。
  • 再生数・長さ・作成日時metrics.views_count、duration_seconds、published_at で、累計再生数、秒単位の長さ、クリップが作られた時刻がわかります。
  • 配信者情報つきauthor には配信者のID、ログイン名、表示名、チャンネルURL、アイコン、パートナー状態が入り、どのチャンネルの場面かが一目でわかります。
  • slugで安定して識別shortcode にクリップのslug、id に数値のクリップIDが入り、タイトルや再生数が変わっても値は変わりません。

Twitch Clip Downloader API のパラメータ

パラメータ必須説明
url必須公開されているTwitchクリップのURLを1件。https://www.twitch.tv/<channel>/clip/<slug> または https://clips.twitch.tv/<slug> の形式です。

Twitch Clip Downloader API の使い方

クリップURLを1件送り、1行の結果としてクリップを読み取ります。

  1. /v1/twitch/clip に {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} をPOSTします。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からクリップを読み取ります。has_more と results.next_cursor は通常のページング規則に従い、この1行の結果では空になります。
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 をグラフにして伸び方を確認します。
  • 転載時のクレジット表記: まとめ動画やニュースレター、SNS投稿に使う前に、author のログイン名、表示名、チャンネルURLで出典を正しく記載します。

Twitch Clip Downloader API 活用のヒント

  • media のURLは署名付きで約1日後に無効になるため、タスク完了後は早めにMP4をダウンロードしてください。
  • 同じクリップが2種類のリンクで共有されることがあるため、保存時は送信したURLではなく shortcode か id をキーにしてください。
  • クリップを再取得するたびに collected_at を views_count と並べて保存すると、後から数値を比較できます。

Twitch Clip Downloader API 以外に別の種類の公開Twitchデータが必要な場合は、これらのAPIをご利用ください。

  • Twitch Profile API — 公開Twitchユーザー名1件から正規化されたアカウントレコードを取得し、取得可能なアカウント情報、プロフィール文、画像、アカウント属性、表示中の指標、取得情報を返します。
  • Twitch User Videos API

他のプラットフォームを見る

Twitchのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Twitch Clip Downloader API — よくある質問

Twitch Clip Downloader APIは、クリップURLから公開されているTwitchクリップを取得するためのプログラム用インターフェースです。クリップのタイトル、再生数、長さ、作成日時、slug、配信者プロフィール、MP4直リンクとサムネイルを返します。

1回のリクエストでクリップのリンクを1件送ります。twitch.tv/チャンネル/clip/slug と clips.twitch.tv/slug のどちらでも構いません。リンクの形式はタスク作成前に確認されます。

できます。media にクリップのMP4直リンクが入ります。URLは署名付きで約1日で失効するため、タスク完了後すぐに取得してください。

標準の結果にはクリップ本体、指標、配信者が入ります。ゲーム名、クリップを切り出したアカウント、利用できるすべての画質は、タスクのファイル一覧にある生のJSONLに保存されます。

1回のリクエストでクリップ1件を取得し、0.5クレジットかかります。クリップが見つからない場合はタスクが失敗し、全額返金されます。