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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Erforderliche 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.
- 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.
- 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.
- 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.
- 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.
- 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.
Verwandte APIs
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.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API