tiktok/
live-room-info

Einen öffentlichen TikTok-Livestream anhand zusammengehöriger Raum- und Host-IDs abrufen – mit Titel, Status, Identität des Hosts, Cover-Bild, Zuschauerzahl, Anzahl der Likes und Erfassungszeitpunkt.

TikTok Live Room Info API

Bekannter Livestream
Zuschauer-Momentaufnahme
Host-Kontext
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 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

ParameterErforderlichBeschreibung
room_idErforderlichErforderliche, nicht leere Kennung des Livestreams. Geben Sie die numerische Kennung als Zeichenfolge an, aus einer Quelle, die die aktuelle TikTok-Live-Sitzung bereitstellt.
user_idErforderlichErforderliche, 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.

  1. 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.
  2. Senden Sie beide nicht leeren Kennungen als Zeichenfolgen per POST an /v1/tiktok/live-room-info.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
  4. 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.

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.

Weitere Plattformen entdecken

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

TikTok Live Room Info API — FAQ

TikTok Live Room Info API ist eine Schnittstelle, die einen bekannten öffentlichen Livestream anhand von room_id und user_id des Hosts abruft. Als Momentaufnahme liefert sie Titel und Status des Livestreams, Identität des Hosts, Cover-Bild, Zahlen zu Zuschauern und Likes sowie den Erfassungszeitpunkt.

Verwenden Sie eine Quelle für Live-Sitzungen, die room_id bereitstellt, und halten Sie sie gepaart mit der numerischen user_id des Hosts. Ein TikTok-Profiles-Ergebnis kann user_id in seinem normalisierten Feld id liefern, doch der aktuelle TikTok-Katalog von SocQ entdeckt keine room_id.

Der Livestream kann beendet oder nicht mehr verfügbar sein oder nicht mehr zum übergebenen Host passen, oder eine der Kennungen kann ungültig sein. SocQ speichert ein Ergebnis nur dann, wenn die Quelle eine nicht leere room_id auflöst.

Nein. Er führt eine einzelne Abfrage für einen bereits bekannten Livestream aus und durchsucht weder angesagte Livestreams, noch wartet er darauf, dass ein Konto live geht, zeichnet Video auf, erfasst Live-Ereignisse oder richtet eine fortlaufende Überwachung ein.

Es sind Momentaufnahmen, die zum Zeitpunkt der Erfassung sichtbar sind und sich sofort ändern können. Speichern Sie collected_at zusammen mit den Zahlen, statt sie als fortlaufenden Feed zu behandeln.

Jeder gespeicherte normalisierte Livestream-Datensatz kostet 0,5 Credits, ohne Grundgebühr für die Aufgabe. Die Schätzung geht von einem Ergebnis aus, und ein leeres Ergebnis wird nicht berechnet.