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行の結果としてクリップを読み取ります。
- /v1/twitch/clip に {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} をPOSTします。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 と並べて保存すると、後から数値を比較できます。
関連API
Twitch Clip Downloader API 以外に別の種類の公開Twitchデータが必要な場合は、これらのAPIをご利用ください。
- Twitch Profile API — 公開Twitchユーザー名1件から正規化されたアカウントレコードを取得し、取得可能なアカウント情報、プロフィール文、画像、アカウント属性、表示中の指標、取得情報を返します。
- Twitch User Videos API