tiktok/
comment-replies

Öffentliche TikTok-Antworten zu einem Kommentar anhand von Video-URL und Kommentar-ID erfassen – mit Text, Autoren, Zeitstempeln, Interaktionen und Kontext des übergeordneten Kommentars als normalisierte Datensätze.

TikTok Comment Replies API

Antworten auf bekannte Kommentare
Autorenkontext
Verweis auf den übergeordneten Kommentar
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 Comment Replies

TikTok Comment Replies sind öffentliche Antworten unterhalb eines bekannten Video-Kommentars – mit Antworttext, Autorenidentität, Zeitstempeln, sichtbaren Likes und Antwortzahlen sowie einem Verweis auf den übergeordneten Kommentar. Diese Gesprächsdaten eignen sich für die Rekonstruktion von Verläufen, die Prüfung von Teilnehmenden, die Recherche zu Reaktionen und die Beobachtung auf Antwortebene.

Funktionen der TikTok Comment Replies API

  • Antwortbereich eines bestimmten KommentarsKombinieren Sie eine unterstützte TikTok-Video-URL mit der bekannten comment_id, um den öffentlichen Antwort-Feed dieses Kommentars zu erfassen statt der Kommentare der obersten Ebene des Videos.
  • Felder zu Antwort, Autor und InteraktionLiefert Antwort-IDs und Text, öffentliche Autorenidentität und Kontomerkmale, Zeitstempel, sichtbare Likes und Antwortzahlen, Erwähnungen sowie den Kontext des Quellvideos.
  • Begrenzter, deduplizierter DurchlaufFolgt den verfügbaren Antwort-Cursors, entfernt doppelte Kommentar-IDs und endet am angeforderten Limit, am Ende des Verlaufs oder an der Obergrenze von 100 Seiten pro Erfassung.

Parameter der TikTok Comment Replies API

ParameterErforderlichBeschreibung
urlErforderlichErforderliche TikTok-Video-URL auf tiktok.com, www.tiktok.com oder m.tiktok.com mit einem Pfad der Form /video/{numeric_id}.
comment_idErforderlichErforderliche, nicht leere öffentliche Kommentar-ID des ausgewählten Kommentars der obersten Ebene desselben Videos.
results_limitOptionalMaximale Anzahl angeforderter Antworten für den Kommentar; Standardwert 100, zulässig sind ganze Zahlen von 20 bis 2.000.

So verwenden Sie die TikTok Comment Replies API

Beginnen Sie mit der ID eines Kommentars der obersten Ebene zu einem TikTok-Video, senden Sie eine asynchrone Aufgabe für die Antworten und lesen Sie die normalisierten Datensätze per Cursor-Paginierung des Ergebnisses aus.

  1. Rufen Sie die TikTok Comments API für das Video auf und wählen Sie die id des Kommentars der obersten Ebene, dessen Antworten Sie benötigen.
  2. Senden Sie dieselbe Video-url, diese comment_id und optional ein results_limit per POST an /v1/tiktok/comment-replies.
  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 und übergeben Sie results.next_cursor, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/tiktok/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@loganpaul/video/7411198650782731563","comment_id":"7411205662439736097","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

Anwendungsfälle der TikTok Comment Replies API

  • Rekonstruktion des Verlaufs eines bekannten Kommentars: Verknüpfen Sie Antwort-IDs, extra.parent_comment_id und extra.input_url, um den öffentlichen Antwortzweig unter einem ausgewählten Kommentar der obersten Ebene wiederherzustellen.
  • Prüfung der Reaktionen auf Antwortebene: Nutzen Sie Antworttext, Zeitstempel, sichtbare Likes und Antwortzahlen, um öffentliche Reaktionen innerhalb eines klar umrissenen Gesprächs zu prüfen und zu vergleichen.
  • Zuordnung der Gesprächsteilnehmer: Nutzen Sie öffentliche Autoren-IDs, Benutzernamen, Profillinks, Avatare und Kontomerkmale, um die Teilnehmenden im zurückgegebenen Antwort-Feed zuzuordnen.

Profi-Tipps zur TikTok Comment Replies API

  • Entnehmen Sie comment_id der normalisierten id eines Kommentars der obersten Ebene aus TikTok Comments und verwenden Sie die Video-URL dieses Ergebnisses erneut; eine Video-ID ist keine Kommentar-ID.
  • Prüfen Sie den Host der URL und den numerischen Pfad /video/ vor dem Senden, damit verkürzte Links, Profil-Links oder Links ohne Video die Eingabeprüfung nicht scheitern lassen.
  • Setzen Sie results_limit auf die benötigte Menge an Antworten und beachten Sie, dass der öffentliche Verlauf vor dem Limit enden kann und die Erfassung nach 100 Quellseiten stoppt.
  • Deduplizieren Sie beim Zusammenführen von Aufgaben nach der Antwort-id und behalten Sie dabei extra.parent_comment_id und extra.input_url bei, damit Antworten dem richtigen Gespräch zugeordnet bleiben.
  • Behandeln Sie Antworttext, Autorenfelder, Kennzahlen, Erwähnungen und Zeitstempel als nullbar und maskieren Sie nutzergenerierten Text, bevor Sie ihn in nachgelagerten Tools anzeigen.

Ergänzend zur TikTok Comment Replies 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 Comments API — Öffentliche Kommentare der obersten Ebene, Autoren, Interaktionen, Erwähnungen und Merkmale zur Creator-Interaktion erfassen.
  • TikTok Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
  • TikTok Search API — Öffentliche Videos per Keyword suchen – mit unterstützten Sortier- und Veröffentlichungsfiltern.
  • TikTok Comment Keywords API — Die häufigsten Keywords in den Kommentaren eines Videos finden – mit den Kommentaren dahinter.

Weitere Plattformen entdecken

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

TikTok Comment Replies API — FAQ

TikTok Comment Replies API ist eine Schnittstelle, die anhand von Video-URL und Kommentar-ID die öffentlichen Antworten unter einem bekannten TikTok-Kommentar erfasst. Zurückgegeben werden normalisierter Antworttext, Autorenidentität, Zeitstempel, sichtbare Interaktionen und Kontext des übergeordneten Kommentars.

Rufen Sie die TikTok Comments API für dasselbe Video auf und verwenden Sie die normalisierte id des ausgewählten Kommentars der obersten Ebene. Behalten Sie diese id beim Senden der Aufgabe zusammen mit der URL des Quellvideos bei.

Verwenden Sie eine URL auf tiktok.com, www.tiktok.com oder m.tiktok.com, deren Pfad /video/ gefolgt von einer numerischen Video-ID enthält. Ein verkürzter Link, eine Profil-URL oder eine Video-URL ohne nicht leere comment_id erfüllt die Spezifikation der Anfrage nicht.

Ein Datensatz kann Antwort-ID und Text, Quellvideo-URL, öffentliche Autorenidentität und Kontomerkmale, Zahlen zu Likes und Antworten, Erwähnungen, created_at, collected_at, extra.parent_comment_id und extra.input_url enthalten.

results_limit ist eine Obergrenze und keine Garantie. Die Erfassung kann enden, wenn der öffentliche Antwort-Feed zu Ende ist, keine neuen eindeutigen Antwort-IDs mehr kommen, der Feed seinen Cursor nicht weiterbewegt oder die Obergrenze von 100 Seiten erreicht ist.

Jede gespeicherte normalisierte Antwort kostet 0,5 Credits, ohne Grundgebühr für die Aufgabe. Die erste Schätzung beruht auf results_limit oder dessen Standardwert 100, die endgültige Nutzung folgt den tatsächlich gespeicherten Datensätzen; ohne gespeicherte Antworten fällt keine Ergebnisgebühr an.