TwitchTwitch-ClipsVideo-DownloadStreamingAPI-Leitfaden

Twitch Clip Downloader API: Aufrufe, Streamer und Videodatei eines Clips abrufen

Die neue SocQ Twitch Clip Downloader API macht aus einer Clip-URL Titel, Aufrufe, Länge, Erstellungszeit, Streamer und einen herunterladbaren MP4-Link, für 0,5 Credits.

SocQAktualisiert am 19. November 20266 Min. Lesezeit

Clips sind die kurzen Highlights, die Zuschauer aus einem Twitch-Stream schneiden, und genau sie werden auf X, Reddit und Discord geteilt. Wenn Sie herausragende Momente archivieren, messen möchten, wie weit sich ein Clip verbreitet hat, oder beim erneuten Posten den richtigen Kanal nennen müssen, brauchen Sie die Daten des Clips und seine Videodatei in einer Form, die Ihr Code speichern kann.

Am 2026-11-17 hat SocQ die Twitch Clip Downloader API zur Twitch-Plattformseite hinzugefügt, neben den bestehenden Endpunkten Twitch Profile und User Videos. Dieser Leitfaden zeigt, was der Endpunkt zurückgibt, wie die Anfrage aussieht, was er kostet und welche Grenzen Sie einplanen sollten.

Kurze Antwort: Senden Sie {"url": "<clip URL>"} an POST https://api.socq.ai/v1/twitch/clip. Speichern Sie die zurückgegebene task_id, fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, und lesen Sie dann den einzelnen Datensatz in data.results.items. Jede Anfrage kostet 0,5 Credits ($0,0025). Laden Sie die Videodatei zügig herunter, denn ihr Link läuft nach etwa einem Tag ab.

Was der Endpunkt zurückgibt

1 SocQ-Credit = $0,005.

EndpunktRückgabePreis
Twitch Clip Downloader APIEin Clip: Titel, Aufrufzahl, Länge, Erstellungszeit, Streamer mit Avatar, Videodatei und Vorschaubild0,5 Credits ($0,0025) pro Aufruf

Der Datensatz verwendet das Standard-Videoschema von SocQ. Die für Clips wichtigen Felder:

FeldBedeutung
idDie numerische Clip-ID von Twitch
shortcodeDer Clip-Slug aus der URL
urlDie Clip-URL
textDer Clip-Titel
published_atErstellungszeitpunkt des Clips (ISO 8601)
duration_secondsClip-Länge in Sekunden
metrics.views_countAufrufe des Clips
authorDer Streamer: id, username, name, url, avatar_url, is_verified
media[0].urlDie MP4-Datei des Clips
media[0].thumbnail_urlDas Vorschaubild des Clips
collected_atZeitpunkt, zu dem SocQ den Datensatz erfasst hat

Deklarierte Felder bleiben im Datensatz, auch wenn sie keinen Wert haben. Im Beispiel der Dokumentation liefert ein 27 Sekunden langer Clip views_count: 69776, während metrics.likes_count, metrics.comments_count, hashtags und audio den Wert null haben.

Authentifizierung und asynchroner Aufgabenablauf

Alle Anfragen authentifizieren sich mit einem API-Schlüssel. Derselbe Header gilt für Übermittlung, Aufgabenstatus und Ergebnisabruf:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Jede Erfassung läuft als Hintergrundaufgabe:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Der Übermittlungsaufruf antwortet sofort mit data.task_id und data.status. Fragen Sie die Aufgabe mit dieser ID ab:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Wenn status den Wert succeeded hat, enthält die Antwort result_count, credits_amount und den Datensatz in data.results.items. Eine fehlgeschlagene Aufgabe enthält error_message. Eine Zeitüberschreitung auf Client-Seite bricht die Aufgabe nicht ab. Setzen Sie daher mit derselben Aufgaben-ID fort, statt erneut zu übermitteln. Ein 402 bedeutet, dass das Konto keine Credits mehr hat, und ein 429, dass der Schlüssel ein Raten- oder Credit-Limit erreicht hat.

Anders als die meisten SocQ-Endpunkte nimmt der Anfragekörper des Clip Downloader nur url entgegen. callback_url ist nicht aufgeführt, fragen Sie die Aufgabe also per Polling ab.

Einen Clip anfragen

Übergeben Sie eine Clip-URL in url. Beide Formen funktionieren: twitch.tv/<channel>/clip/<slug> und clips.twitch.tv/<slug>. (Dokumentation)

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"}'

Jede Anfrage nimmt eine URL entgegen und liefert eine Zeile. Für einen Batch übermitteln Sie eine Aufgabe pro Clip und speichern jede task_id zusammen mit ihrer URL, damit ein erneuter Versuch denselben Clip nicht doppelt übermittelt.

Der Link in media[0].url ist signiert und läuft nach etwa einem Tag ab. Wenn Sie eine Kopie des Clips brauchen, laden Sie ihn herunter, sobald die Aufgabe erfolgreich ist, und legen Sie die Datei in Ihrem eigenen Speicher ab. Bewahren Sie id, shortcode und url des Datensatzes zusammen mit der Datei auf, damit Sie den Clip erneut anfragen können, falls Sie den Quelllink je wieder brauchen.

Ein minimaler Python-Ablauf:

import os, time, requests

API = "https://api.socq.ai"
headers = {"Authorization": f"Bearer {os.environ['SOCQ_API_KEY']}"}
clip_url = "https://clips.twitch.tv/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"

task = requests.post(f"{API}/v1/twitch/clip", headers=headers,
                     json={"url": clip_url}).json()["data"]

while task["status"] in ("queued", "running"):
    time.sleep(3)
    task = requests.get(f"{API}/v1/tasks/{task['task_id']}",
                        headers=headers).json()["data"]

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error_message"))

clip = task["results"]["items"][0]
video = requests.get(clip["media"][0]["url"], timeout=60)
with open(f"{clip['shortcode']}.mp4", "wb") as f:
    f.write(video.content)

Ergänzen Sie HTTP-Statusprüfungen, begrenzte Wiederholungen und Logging, bevor Sie das Skript in großem Umfang ausführen.

Wann sich der Endpunkt lohnt

  • Highlight-Archive. Sichern Sie die Clips Ihres Kanals oder Ihrer Talente mit Titel, Erstellungszeit und Aufrufen, bevor sich der Quelllink ändert.
  • Reichweitenmessung. Fragen Sie einen Clip erneut ab, nachdem er geteilt wurde, und vergleichen Sie metrics.views_count mit dem ersten Snapshot. Jede Prüfung kostet 0,5 Credits.
  • Quellenangabe. author nennt den Streamer, der den Moment übertragen hat, samt Profillink, sodass Reposts den richtigen Kanal nennen können.
  • Content-Pipelines. Geben Sie die MP4-Datei an Schnitt, Untertitelung oder die Aufbereitung als Kurzvideo weiter.

Kostenplanung: Der Preis ist pauschal, 100 Clips kosten also 50 Credits ($0,25) und 1.000 Clips 500 Credits ($2,50). Eine wöchentliche Aufrufprüfung für 50 beobachtete Clips kostet 25 Credits ($0,125) pro Woche.

Respektieren Sie die Rechte des Streamers und aller Personen, die in einem Clip zu sehen sind, und halten Sie sich an die Nutzungsbedingungen von Twitch, wenn Sie das Video weiterverwenden.

Verwandte Twitch-Endpunkte

Der Clip-Datensatz verrät Ihnen, wer gestreamt hat. Von dort gelangen Sie zum Kanal:

  • Die Twitch Profile API liefert ein öffentliches Twitch-Profil anhand eines username.
  • Die Twitch User Videos API liefert eine Seite der öffentlichen Videos eines Nutzers, mit filter_by (etwa archive, highlight oder upload) und sort_by (time oder views).

Übergeben Sie author.username aus einem Clip an einen der beiden. Clips und Videos anderer Plattformen im gleichen normalisierten Format finden Sie im TikTok-Scraping-Leitfaden und in 7 beste YouTube Scraper APIs.

FAQ

Was kostet die Twitch Clip Downloader API?

0,5 Credits pro Anfrage, also $0,0025. Jede Anfrage liefert einen Clip.

Welche Clip-URL-Formate werden akzeptiert?

https://www.twitch.tv/<channel>/clip/<slug> und https://clips.twitch.tv/<slug>.

Der Link ist signiert und läuft nach etwa einem Tag ab. Laden Sie die Datei zügig herunter, wenn Sie eine Kopie brauchen.

Kann ich mehrere Clips in einer Anfrage senden?

Nein. url nimmt eine Clip-URL entgegen. Übermitteln Sie eine Aufgabe pro Clip.

Liefert der Endpunkt Likes oder Kommentare zu einem Clip?

Der Datensatz enthält die Aufrufzahl. Im Beispiel der Dokumentation sind likes_count und comments_count null, planen Sie also nicht damit.

TWITCH API

Workflow mit einer öffentlichen Twitch-URL testen

Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.

Twitch-APIs ansehen