TikTok Live Room Info
TikTok Live Room Info liefert die Momentaufnahme eines aktiven öffentlichen Livestreams – mit Titel, Status, Identität des Hosts, Cover-Bild sowie den sichtbaren Zahlen zu Zuschauern und Likes. Diese Felder eignen sich für Prüfungen des Live-Status, Zuschauer-Momentaufnahmen, die Anreicherung von Livestreams und Berichte mit Zeitstempel für bereits bekannte Livestreams.
Funktionen der TikTok Live Room Info API
- Abfrage über zusammengehörige Raum- und Host-IDLöst einen bekannten Livestream anhand seiner room_id und der passenden user_id des Hosts auf und gibt höchstens einen normalisierten Datensatz live_room zurück.
- Kontext zu Livestream und HostLiefert den aktuellen Titel und Status des Livestreams zusammen mit der öffentlichen ID, dem Benutzernamen und dem Anzeigenamen des Hosts.
- Momentaufnahme von Zuschauern und CoverErfasst die sichtbare Zuschauerzahl, die Anzahl der Likes, das öffentliche Cover-Bild und den Erfassungszeitstempel für die Deutung als Momentaufnahme.
Parameter der TikTok Live Room Info API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
room_id | Erforderlich | Erforderliche, nicht leere Kennung des Livestreams. Geben Sie die numerische Kennung als Zeichenfolge an, aus einer Quelle, die die aktuelle TikTok-Live-Sitzung bereitstellt. |
user_id | Erforderlich | Erforderliche, nicht leere numerische TikTok-Benutzerkennung des Hosts, als Zeichenfolge angegeben und mit demselben Livestream gepaart. |
So verwenden Sie die TikTok Live Room Info API
Kombinieren Sie die Kennungen eines bekannten aktiven Livestreams, senden Sie eine asynchrone Abfrage und lesen Sie die normalisierte Momentaufnahme dann aus den Aufgabenergebnissen.
- Beziehen Sie room_id aus einer Quelle, die die aktuelle TikTok-Live-Sitzung bereitstellt, und die passende user_id des Hosts aus demselben Kontext oder aus einem TikTok-Profiles-Ergebnis.
- Senden Sie beide nicht leeren Kennungen als Zeichenfolgen per POST an /v1/tiktok/live-room-info.
- Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
- Lesen Sie data.results.items aus /v1/tasks/{task_id}?limit=50; ein aufgelöster Livestream erzeugt höchstens einen Datensatz, und der übliche next_cursor kommt nur zum Einsatz, wenn results.has_more gleich true ist.
curl -X POST "https://api.socq.ai/v1/tiktok/live-room-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id":"7523685855395842871","user_id":"6742945285876515845"}'
# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.Anwendungsfälle der TikTok Live Room Info API
- Prüfung des Live-Status zu einem Zeitpunkt: Nutzen Sie den zurückgegebenen Status, den Titel, die Raum-ID und den Wert collected_at, um die verfügbare Momentaufnahme eines bekannten Livestreams zu bestätigen.
- Berichte mit Zuschauer-Momentaufnahmen: Halten Sie viewers_count und likes_count zusammen mit collected_at fest, um Beobachtungen zu verschiedenen Zeitpunkten während einer bekannten Übertragung zu vergleichen.
- Anreicherung von Livestreams: Ergänzen Sie einen bestehenden Livestream-Datensatz um Host-ID, Benutzernamen, Anzeigenamen, Titel, Status und Cover-Bild.
Profi-Tipps zur TikTok Live Room Info API
- Halten Sie room_id zusammen mit der user_id des Hosts aus derselben aktiven Sitzung; passen Raum und Benutzer nicht zusammen, kann das keinen Datensatz oder einen eingabespezifischen Fehler der Quelle zur Folge haben.
- Behalten Sie beide Kennungen als Zeichenfolgen bei, damit große numerische TikTok-IDs nicht von einem Client oder einer Datenbank gerundet werden.
- Führen Sie die Abfrage aus, während der Livestream voraussichtlich läuft, und deuten Sie ein leeres Ergebnis als beendet, nicht verfügbar, ungültig oder nicht passend und nicht als gefundenen Datensatz eines Offline-Livestreams.
- Verwenden Sie collected_at als Beobachtungszeitpunkt für Status und Kennzahlen; created_at ist null und url ist im normalisierten Datensatz leer.
Verwandte APIs
Ergänzend zur TikTok Live Room Info 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 Hashtags API — Öffentliche Videos, Creators, Medien, Sounds und Interaktionen zu angegebenen Hashtags erfassen.
- TikTok Search API — Öffentliche Videos per Keyword suchen – mit unterstützten Sortier- und Veröffentlichungsfiltern.
- TikTok User Videos API — Öffentliche Videos aus dem Profil-Feed per Benutzername erfassen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, Interaktionen und Kontext des Quellkontos.
- TikTok Search Users API — Öffentliche TikTok-Konten per Keyword suchen.
- TikTok Top Search API — Per Keyword nach Videos und Bildbeiträgen suchen – mit Bildunterschriften, Creators und Interaktionszahlen.
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok User Live 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 Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API