douyin/
live-room-detail

Einen öffentlichen Douyin-Livestream anhand einer bekannten numerischen room_id abrufen – mit Titel, Status, Identität des Hosts, Medien, sichtbaren Zahlen zu Zuschauern und Likes sowie der Erfassungszeit.

Douyin Live Room Detail API

Abfrage eines bekannten Livestreams
Host-Kontext
Momentaufnahme des Publikums
0,1 Credits pro Anfrage
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

Douyin Live Room Detail

Douyin-Livestreams sind öffentliche Übertragungssitzungen mit Titel, aktuellem Status, Identität des Hosts, Medien und sichtbaren Zahlen zu Zuschauern und Likes. Diese Felder unterstützen die Anreicherung von Livestream-Katalogen, die Verfolgung des Sitzungsstatus und Vergleiche zu einem bestimmten Zeitpunkt.

Funktionen der Douyin Live Room Detail API

  • Detailabfrage eines bekannten LivestreamsLöst eine bekannte numerische room_id mit einer einzigen Quellanfrage und ohne Paginierung der Quelle in höchstens einen normalisierten Datensatz live_room auf.
  • Kontext zu Livestream und HostHält den verfügbaren Titel, den Status, die Identität des Hosts, die Quell-URL und die Erfassungszeit in einer einheitlichen Struktur zusammen.
  • Sichtbare Momentaufnahme der SitzungErfasst die verfügbaren Zahlen zu Zuschauern und Likes zusammen mit öffentlichen Medien für eine zeitgestempelte Ansicht des Livestreams.

Parameter der Douyin Live Room Detail API

ParameterErforderlichBeschreibung
room_idErforderlichErforderliche Kennung eines Douyin-Livestreams, die nur aus Ziffern besteht. Senden Sie sie als Zeichenfolge, damit lange Kennungen nicht von einem Client gerundet werden.

So verwenden Sie die Douyin Live Room Detail API

Beginnen Sie mit einer bekannten numerischen Livestream-ID, senden Sie die asynchrone Detailaufgabe und lesen Sie danach das gespeicherte normalisierte Ergebnis.

  1. Beschaffen Sie room_id aus einem Livestream-Kontext, der die numerische Kennung preisgibt; dieser Endpunkt ermittelt keine Livestream-IDs.
  2. Senden Sie die Kennung als nicht leere Zeichenfolge aus reinen Ziffern per POST an /v1/douyin/live-room-detail.
  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 ergibt höchstens einen Eintrag, und next_cursor gehört ausschließlich zur Paginierung der in SocQ gespeicherten Ergebnisse.
# Set DOUYIN_ROOM_ID to a known numeric room_id before sending.
curl -X POST "https://api.socq.ai/v1/douyin/live-room-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"room_id\":\"${DOUYIN_ROOM_ID}\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.

Anwendungsfälle der Douyin Live Room Detail API

  • Anreicherung von Livestream-Katalogen: Ergänzen Sie einen Katalog, der die Livestream-ID bereits speichert, um den verfügbaren Titel, Status, Host, Medien, sichtbare Kennzahlen und die Erfassungszeit.
  • Verfolgung von Sitzungsstatus per Momentaufnahme: Behalten Sie getrennt erfasste Datensätze mit collected_at, um den Status des Livestreams und Beobachtungen zum Publikum zu verschiedenen Zeitpunkten zu unterscheiden.
  • Prüfung von Host- und Livestream-Kontext: Betrachten Sie die verfügbare Identität des Hosts neben Titel, Status, Medien und den sichtbaren Sitzungszahlen in einem normalisierten Datensatz.

Profi-Tipps zur Douyin Live Room Detail API

  • Senden Sie room_id als Zeichenfolge in Anführungszeichen mit reinen Ziffern und nicht als JavaScript-Zahl, damit eine lange Kennung jede Ziffer behält.
  • Beschaffen Sie sich eine bekannte room_id, bevor Sie den Endpunkt aufrufen, denn die Anfrage ruft Details ab und ermittelt keine Livestreams.
  • Behalten Sie die übermittelte room_id in Ihrem eigenen Datensatz; das kanonische Livestream-Ergebnis garantiert nicht, dass die Quelle sie als id zurückgibt.
  • Behandeln Sie Titel, Status, Autor, Kennzahlen, Medien, URL und Zeitstempel als nullable, weil die Quelle einzelne öffentliche Felder weglassen kann.
  • Senden Sie weder results_limit noch einen Quell-Cursor; next_cursor paginiert, falls vorhanden, gespeicherte SocQ-Ergebniseinträge und nicht die Anfrage beim Anbieter.

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

Weitere Plattformen entdecken

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

Douyin Live Room Detail API — FAQ

Douyin Live Room Detail API ruft einen bekannten öffentlichen Livestream anhand seiner numerischen room_id ab. Sie liefert die verfügbaren Felder zu Livestream, Host, Medien, Publikum und Erfassungszeit als normalisierten Datensatz zu einem Zeitpunkt.

Nutzen Sie einen öffentlichen Livestream-Kontext, der die numerische Kennung des Livestreams preisgibt, und behalten Sie sie in Ihrem Datensatz. Dieser Endpunkt sucht keine Livestreams und ermittelt keine Livestream-IDs.

Die Validierung zur Laufzeit verlangt eine Zeichenfolge im Format einer reinen Ziffern-ID. Das Beibehalten als Text verhindert außerdem, dass numerische Clients lange IDs runden.

Der normalisierte Datensatz kann Titel, Status, Autor, URL, Medien, die sichtbaren Felder viewers_count und likes_count, created_at und collected_at enthalten. Jedes optionale Quellfeld kann null sein oder fehlen.

Nein. Er sendet eine einzige Detailanfrage und liefert höchstens einen normalisierten Datensatz; das next_cursor der Aufgabenergebnisse ist nur der Standard-Cursor für bereits gespeicherte SocQ-Einträge.

Eine erfolgreiche Aufgabe kostet pauschal 0,10 SocQ-Credits. Die Gebühr ändert sich weder mit der Ergebnisanzahl noch mit einer Paginierungseinstellung.