tiktok/
user-live

Prüfen Sie per Benutzername, ob öffentliche TikTok-Konten live sind – mit Status live oder offline und den verfügbaren Livestream-Details für mehrere Konten in einer Anfrage.

TikTok User Live API

Konten per Benutzername prüfen
Ergebnisse für live und offline
Mehrere Konten pro Anfrage
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

TikTok User Live

Der Live-Status eines TikTok-Kontos beschreibt, ob es zu einem bestimmten Zeitpunkt streamt, und ein aktiver Livestream kann einen Titel, ein Cover und eine Zuschauerzahl haben. Wenn zu diesem Status auch die Identität des Creators und der Zeitpunkt mitgeliefert werden, lässt sich erkennen, welches Konto gestreamt hat und wie aktuell die Information ist.

Funktionen der TikTok User Live API

  • Erkennen, ob eine Abfrage ein Live- oder Offline-Konto gefunden hatJede erfolgreiche Abfrage liefert is_live mit true für live oder false für offline, sodass auch ein Konto, das nicht streamt, einen Statusdatensatz erhält, statt einfach aus den Ergebnissen zu verschwinden.
  • Details zum Livestream eines aktiven Streams ansehenEin Live-Datensatz kann den Titel des Livestreams, den Namen des Creators, das Titelbild und die Zuschauerzahl enthalten und liefert so Informationen zum Stream statt nur eines Ja-oder-Nein-Status.
  • Mit Konto-Handles statt mit Raum-Kennungen beginnenFragen Sie mehrere öffentliche Benutzernamen in einer Anfrage ab, ohne zuvor room_id und user_id ermitteln zu müssen, die für die separate Abfrage der Livestream-Details benötigt werden.

Parameter der TikTok User Live API

ParameterErforderlichBeschreibung
usernamesErforderlichErforderliche Liste mit mindestens einem öffentlichen Konto-Handle, mit oder ohne @; im Playground tragen Sie einen Benutzernamen pro Zeile ein, und in JSON verwenden Sie ein Array wie ["thejustalex", "@tiktok"] statt Profil-URLs.

So verwenden Sie die TikTok User Live API

Die Anfrage startet eine Aufgabe, die im Hintergrund Daten sammelt. Die erste Antwort enthält daher eine Aufgaben-ID statt der fertigen Daten; mit dieser ID prüfen Sie den Fortschritt und rufen die Ergebnisse ab.

  1. Bereiten Sie einen oder mehrere öffentliche Benutzernamen vor, keine Profil- oder Livestream-Links; den Handle nach dem @ können Sie aus dem Profil eines Kontos kopieren.
  2. Ersetzen Sie vor dem Ausführen des Beispiels $SOCQ_API_KEY durch Ihren eigenen API-Schlüssel oder setzen Sie diese Umgebungsvariable. Senden Sie die JSON-Eingabe mit dem unten gezeigten Header Authorization per POST an /v1/tiktok/user-live und speichern Sie die task_id aus der Antwort.
  3. Fragen Sie mit der gespeicherten ID GET /v1/tasks/{task_id} ab, um den Fortschritt zu prüfen. queued bedeutet Warten, running bedeutet, dass die Erfassung läuft, und retrying bedeutet, dass ein weiterer Versuch läuft. Warten Sie auf succeeded, bevor Sie die Ergebnisse lesen; bei failed finden Sie den Grund in error_message.
  4. Wenn die Aufgabe erfolgreich ist, lesen Sie data.results.items: Jedes Element dieser Liste beschreibt den Status eines erfolgreich geprüften Kontos. Eine leere Liste bedeutet, dass die Aufgabe abgeschlossen wurde, ohne Datensätze zurückzugeben.
  5. Wenn data.results.has_more den Wert true hat, ist next_cursor die Markierung für eine weitere Seite gespeicherter Ergebnisse. Kopieren Sie den Wert unverändert in den Parameter cursor von GET /v1/tasks/{task_id}?cursor=... und fahren Sie fort, bis has_more false ist.
curl -X POST "https://api.socq.ai/v1/tiktok/user-live" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["thejustalex"]}'

Anwendungsfälle der TikTok User Live API

  • Eine Live-Status-Übersicht für Konten vorbereiten: Bauen Sie eine Tabelle mit jedem Creator, dem Status live oder offline und dem Erfassungszeitpunkt auf, sodass sich prüfen lässt, welche der übergebenen Konten bei der letzten Beobachtung gestreamt haben.
  • Eine Prüfliste aktiver Livestreams erstellen: Wählen Sie die Datensätze mit is_live=true aus und kombinieren Sie deren Links, Titel und Zuschauerzahlen zu einer Liste aktiver Livestreams, die Sie öffnen und prüfen können.

Profi-Tipps zur TikTok User Live API

  • Entfernen Sie vor dem Senden einer wiederholten Handle-Liste führende @-Zeichen und Duplikate ohne Beachtung der Groß- und Kleinschreibung, damit tiktok und @TikTok Ihre Schätzung der Eingabeanzahl nicht aufblähen.
  • Wenn ein Datensatz is_live=false meldet, zeigen Sie ihn als offline an und lassen Sie die fehlenden Livestream-Felder leer, statt zu melden, die Kontoabfrage sei fehlgeschlagen.
  • Zeigen Sie bei einer Statusübersicht, die Sie selbst aktualisieren, collected_at neben dem Status an, damit ein früheres Ergebnis nicht für eine soeben gemachte Beobachtung gehalten wird.
  • Wenn Sie bereits eine passende room_id und user_id besitzen und eine separate Livestream-Abfrage wünschen, verwenden Sie TikTok Live Room Info, statt diese IDs im Feld usernames zu übergeben.

Ergänzend zur TikTok User Live API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.

  • TikTok Profiles API — Öffentliche Profilidentität, Bios, Kontomerkmale und Zahlen zur Zielgruppe per Benutzername abrufen.
  • TikTok Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
  • TikTok User Videos API — Öffentliche Videos aus dem Profil-Feed per Benutzername erfassen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, Interaktionen und Kontext des Quellkontos.
  • TikTok Live Room Info API — Einen bekannten Livestream anhand des Paars aus Raum-ID und Besitzer-ID nachschlagen und Status, Besitzerkontext, Cover-Medien und Zuschauerzahlen zurückgeben.
  • TikTok Trending Feed API — Den aktuellen öffentlichen Video-Feed einer Region erfassen – mit Feldern zu Creator, Bildunterschrift, Cover, Zeitstempel und sichtbaren Interaktionen.
  • TikTok Live Shopping API — Die Produkte im Warenkorb eines LIVE-Streams auflisten – mit aktuellen Preisen und verkauften Einheiten.

Weitere Plattformen entdecken

Kombinieren Sie TikTok-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok User Live API — FAQ

TikTok User Live API ist eine Schnittstelle, die anhand einer Liste von Benutzernamen prüft, ob öffentliche TikTok-Konten live sind. Sie liefert für jede erfolgreiche Abfrage den Status live oder offline sowie Creator-Informationen und die verfügbaren Livestream-Details aktiver Streams.

Es bedeutet, dass das Konto bei der Prüfung nicht gestreamt hat, nicht dass die Abfrage fehlgeschlagen ist. Ein erfolgreicher Offline-Datensatz hat is_live=false und status=offline, während Titel des Livestreams, Zuschauerzahl oder andere Felder leer sein können.

Nein. Geben Sie den Benutzernamen des Kontos ein, zum Beispiel thejustalex oder @thejustalex; room_id und user_id gehören zur Eingabe der separaten Schnittstelle TikTok Live Room Info.

Nein. Eine Aufgabe prüft den Status, wenn sie läuft, und ist dann beendet. Wenn Sie eine aktualisierte Statusübersicht benötigen, muss Ihre eigene Anwendung eine weitere Prüfung ausführen und den neuen Erfassungszeitpunkt speichern.

Nein. Null ist ein Zahlenwert, während null (leer) bedeutet, dass die Messung fehlt. Halten Sie diese Fälle getrennt und rechnen Sie bei Offline-Datensätzen mit leeren Livestream-Messwerten.

Jeder zurückgegebene Status kostet 0,5 Credits, auch erfolgreiche Offline-Ergebnisse, ohne Grundgebühr. Drei verschiedene Benutzernamen ergeben zum Beispiel geschätzt 1,5 Credits, und drei zurückgegebene Status kosten 1,5 Credits, auch wenn zwei Konten offline sind.