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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
room_id | Erforderlich | Erforderliche 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.
- Beschaffen Sie room_id aus einem Livestream-Kontext, der die numerische Kennung preisgibt; dieser Endpunkt ermittelt keine Livestream-IDs.
- Senden Sie die Kennung als nicht leere Zeichenfolge aus reinen Ziffern per POST an /v1/douyin/live-room-detail.
- 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 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.
Verwandte APIs
Ergänzend zur Douyin Live Room Detail API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Douyin-Daten benötigen.