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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche TikTok-Video-URL auf tiktok.com, www.tiktok.com oder m.tiktok.com mit einem Pfad der Form /video/{numeric_id}. |
comment_id | Erforderlich | Erforderliche, nicht leere öffentliche Kommentar-ID des ausgewählten Kommentars der obersten Ebene desselben Videos. |
results_limit | Optional | Maximale 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.
- 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.
- Senden Sie dieselbe Video-url, diese comment_id und optional ein results_limit per POST an /v1/tiktok/comment-replies.
- 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 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.
Verwandte APIs
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.
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API