Douyin Video Comments
Douyin-Videokommentare sind öffentliche Reaktionen zu einem Video mit Text, Identität des Autors, Veröffentlichungskontext und sichtbaren Signalen zu Likes oder Antworten. Diese Datensätze unterstützen die Auswertung der Reaktionen des Publikums, die Abbildung von Unterhaltungen und den Vergleich von Interaktionen zu einem bestimmten Zeitpunkt.
Funktionen der Douyin Video Comments API
- Gezielter Abruf per Video-URLErmittelt die numerische Video-ID aus einer öffentlichen URL von douyin.com oder iesdouyin.com, deren Pfad /video/{numeric_id} enthält.
- Begrenzte Erfassung einer SeiteFordert bis zu 20 Kommentarzeilen von der ersten Quellseite an, wobei results_limit die gespeicherte Teilmenge von 1 bis 20 festlegt.
- Kanonischer KommentarkontextLiefert Datensätze vom Typ CommentItem 1.0 mit Text, Identität des Autors, Beziehungen zu Video und übergeordnetem Kommentar, Veröffentlichungs- und Erfassungszeit sowie sichtbaren Zahlen zu Likes oder Antworten.
Parameter der Douyin Video Comments API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche öffentliche URL auf douyin.com, iesdouyin.com oder einer Subdomain. Ihr Pfad muss /video/ gefolgt von einer numerischen Video-ID enthalten. |
results_limit | Optional | Optionale ganze Zahl von 1 bis 20. Ohne Angabe gilt 20; die Integration fordert nur die erste Quellseite an. |
So verwenden Sie die Douyin Video Comments API
Legen Sie eine direkte öffentliche Douyin-Video-URL fest, senden Sie die asynchrone Aufgabe und lesen Sie die für diese Aufgabe gespeicherten normalisierten Kommentare.
- Setzen Sie DOUYIN_VIDEO_URL auf eine öffentliche URL von douyin.com oder iesdouyin.com mit einem Pfad /video/{numeric_id}.
- Senden Sie url und das optionale results_limit per POST an /v1/douyin/video-comments und speichern Sie task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder fehlschlägt.
- Lesen Sie data.results.items und folgen Sie next_cursor nur, solange has_more den Wert true hat, um die bereits in SocQ gespeicherten Datensätze weiter durchzugehen.
curl -X POST "https://api.socq.ai/v1/douyin/video-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"${DOUYIN_VIDEO_URL}\",\"results_limit\":20}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Douyin Video Comments API
- Auswertung der Reaktionen des Publikums: Nutzen Sie Kommentartext, Identität des Autors und sichtbare Zahlen zu Likes oder Antworten, um die Reaktionen auf ein bekanntes öffentliches Video auszuwerten.
- Abbildung von Kommentarbeziehungen: Verknüpfen Sie die zurückgegebenen Kommentare mit dem Quellvideo und einem gegebenenfalls übergebenen übergeordneten Verweis über post_id und parent_id.
- Vergleich von Interaktions-Momentaufnahmen: Vergleichen Sie sichtbare Kommentarsignale über ausgewählte Videos oder Erfassungszeitpunkte hinweg und behalten Sie collected_at als Beobachtungszeitstempel bei.
Profi-Tipps zur Douyin Video Comments API
- Lösen Sie einen geteilten oder weitergeleiteten Link vor dem Senden in die endgültige akzeptierte URL /video/{numeric_id} auf, damit die Validierung von Host und Pfad gelingt.
- Lassen Sie results_limit weg, um 20 Zeilen anzufordern, oder wählen Sie eine kleinere ganze Zahl, wenn Sie nur eine Teilmenge der einen zurückgegebenen Quellseite benötigen.
- Verwenden Sie die ursprüngliche task_id weiter und folgen Sie next_cursor nur, wenn has_more den Wert true hat; dieser Cursor liest gespeicherte Zeilen und ruft keine weitere Quellseite ab.
- Nutzen Sie die id des Kommentars als primären Schlüssel zur Deduplizierung und lassen Sie parent_id oder post_id null, wenn die Quellzeile keine Beziehung enthält.
- Behandeln Sie Angaben zum Autor, published_at und einzelne Kennzahlen als optional und versehen Sie jede Momentaufnahme eines Ergebnisses mit collected_at.
- Maskieren Sie Kommentartext, bevor Sie ihn in HTML einfügen, denn öffentliche Kommentare sind von Nutzern erstellte Inhalte.
Verwandte APIs
Ergänzend zur Douyin Video Comments API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Douyin-Daten benötigen.
- Douyin Live Room Detail API — Einen bekannten Douyin-Livestream über die numerische Raum-ID abrufen – mit normalisiertem Raumkontext, Identität des Hosts, Medien und sichtbaren Zuschauerzahlen.
- Douyin User Profile API
- Douyin User Videos API
- Douyin Video Detail API
- Douyin Video Search API