Twitch Clip Downloader
Ein Twitch-Clip ist ein kurzes Highlight, das Zuschauer aus einem Livestream oder VOD schneiden, mit eigenem Titel, Slug, Aufrufzahl, Länge, Erstellungszeit, dem ursprünglichen Streamer sowie gerendertem Video und Vorschaubild. Damit lassen sich besondere Momente samt Video archivieren, die Verbreitung eines Clips messen und beim Teilen der richtige Kanal nennen.
Funktionen der Twitch Clip Downloader API
- Beide Clip-LinkformateLinks im Format twitch.tv/kanal/clip/slug und Kurzlinks wie clips.twitch.tv/slug führen zum selben Clip, sodass aus Chat, X oder Discord kopierte Links direkt funktionieren.
- Abspielbare MP4 mit Vorschaubildmedia enthält eine direkte MP4-Adresse des Clips samt thumbnail_url und damit alles, was zum Speichern oder Anzeigen des Highlights nötig ist.
- Reichweite und Zeitpunktmetrics.views_count, duration_seconds und published_at liefern die Gesamtaufrufe, die Länge in Sekunden und den Zeitpunkt der Erstellung.
- Streamer direkt verknüpftauthor enthält ID, Login, Anzeigenamen, Kanal-Link, Avatar und Partnerstatus des Streamers, damit jeder Clip dem ausstrahlenden Kanal zugeordnet ist.
- Slug als stabiler Schlüsselshortcode gibt den Slug und id die numerische Clip-ID zurück; beide bleiben gleich, auch wenn sich Titel und Aufrufzahl ändern.
Parameter der Twitch Clip Downloader API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Ein öffentlicher Twitch-Clip-Link im Format https://www.twitch.tv/<channel>/clip/<slug> oder https://clips.twitch.tv/<slug>. |
So verwenden Sie die Twitch Clip Downloader API
Einen Clip-Link senden und den Clip als einzelne Zeile lesen.
- Senden Sie {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} per POST an /v1/twitch/clip.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status succeeded ist.
- Lesen Sie den Clip aus results.items; has_more und results.next_cursor folgen den üblichen Paging-Regeln und bleiben bei dieser einzelnen Zeile leer.
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"}'Anwendungsfälle der Twitch Clip Downloader API
- Stream-Highlights archivieren: Die MP4 aus media mit Titel, Streamer und published_at speichern und so eine durchsuchbare Sammlung der besten Momente eines Kanals aufbauen.
- Verbreitung eines Clips verfolgen: Denselben Clip über mehrere Tage erneut abrufen und metrics.views_count gegen collected_at auftragen, um zu sehen, ob ein Highlight Fahrt aufnimmt.
- Geteilte Clips korrekt nennen: Login, Anzeigename und Kanal-Link aus author nutzen, um einen Clip vor der Verwendung in Zusammenschnitten, Newslettern oder Posts richtig zuzuordnen.
Profi-Tipps zur Twitch Clip Downloader API
- Laden Sie die MP4 bald nach Abschluss der Aufgabe herunter, denn die Adresse in media ist signiert und funktioniert nach etwa einem Tag nicht mehr.
- Speichern Sie Clips unter shortcode oder id statt unter der eingereichten URL, weil ein Clip über beide Linkformate geteilt werden kann.
- Legen Sie bei jeder Aktualisierung collected_at neben views_count ab, damit spätere Messwerte vergleichbar bleiben.
Verwandte APIs
Ergänzend zur Twitch Clip Downloader API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Twitch-Daten benötigen.
- Twitch Profile API — Einen öffentlichen Twitch-Benutzernamen in einen normalisierten Kontodatensatz auflösen – mit verfügbarer Identität, Bio, Bildmaterial, Kontomerkmalen, sichtbaren Kennzahlen und Erfassungskontext.
- Twitch User Videos API