douyin/
video-comments

Eine Seite öffentlicher Kommentare aus einer direkten Douyin-Video-URL erfassen – mit normalisierten Feldern zu Text, Autor, Beziehung, Zeit und sichtbarer Interaktion.

Douyin Video Comments API

Direkte Video-URL
Eine Quellseite
CommentItem 1.0
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 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

ParameterErforderlichBeschreibung
urlErforderlichErforderliche öffentliche URL auf douyin.com, iesdouyin.com oder einer Subdomain. Ihr Pfad muss /video/ gefolgt von einer numerischen Video-ID enthalten.
results_limitOptionalOptionale 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.

  1. Setzen Sie DOUYIN_VIDEO_URL auf eine öffentliche URL von douyin.com oder iesdouyin.com mit einem Pfad /video/{numeric_id}.
  2. Senden Sie url und das optionale results_limit per POST an /v1/douyin/video-comments und speichern Sie task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder fehlschlägt.
  4. 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 true

Anwendungsfä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.

Ergänzend zur Douyin Video Comments 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 Video Comments API — FAQ

Douyin Video Comments API erfasst eine Seite öffentlicher Kommentare aus einer Douyin-Video-URL mit numerischem Videopfad und liefert normalisierte Felder zu Text, Autor, Beziehung, Zeit sowie sichtbaren Likes oder Antwortzahlen.

Die url muss douyin.com, iesdouyin.com oder eine Subdomain verwenden, und ihr Pfad muss /video/ gefolgt von einer numerischen ID enthalten. Profil-, Such- und Nicht-Video-Pfade werden abgelehnt.

results_limit akzeptiert ganze Zahlen von 1 bis 20 und hat den Standardwert 20. Die Aufgabe fordert eine Quellseite an und kann daher nicht auf weitere Quellseiten fortgesetzt werden.

CommentItem 1.0 enthält grundlegende Identitäts- und Zeitfelder sowie Text, Autor, parent_id, post_id und metrics mit likes_count und replies_count. Optionale Quellfelder bleiben null, wenn sie nicht verfügbar sind.

Er sendet keine eigene Anfrage für Antwortseiten. Eine zurückgegebene Zeile kann replies_count und, sofern die Quelle ihn liefert, eine parent_id enthalten; diese Felder bedeuten jedoch nicht, dass der Text der Antworten erfasst wurde.

next_cursor gehört zu GET /v1/tasks/{task_id} und paginiert Datensätze, die SocQ nach dem Erfolg bereits gespeichert hat. Er fordert nie die nächste Quellseite von Douyin an.

Jede erfolgreiche Aufgabe kostet pauschal 0,10 SocQ-Credits, unabhängig von results_limit oder der Zahl der zurückgegebenen Einträge; fehlgeschlagene Aufgaben folgen dem Erstattungsweg der Laufzeit.