TikTok Comment Replies
Le risposte ai commenti di TikTok sono repliche pubbliche sotto un commento noto di un video, con testo della risposta, identità dell’autore, timestamp, Mi piace e numero di risposte visibili e un riferimento al commento padre. Questi record di conversazione supportano la ricostruzione dei rami, la revisione dei partecipanti, la ricerca sulle repliche e il monitoraggio a livello di risposta.
Funzionalità della TikTok Comment Replies API
- Ambito delle risposte indirizzato al commentoAbbina l’URL di un video TikTok supportato al relativo comment_id noto per raccogliere il feed pubblico delle risposte a quel commento, invece dei commenti di primo livello del video.
- Campi di risposta, autore ed engagementRicevi ID e testo delle risposte, identità pubblica dell’autore e flag dell’account, timestamp, Mi piace e numero di risposte visibili, menzioni e contesto del video di origine.
- Scansione limitata e deduplicataSegue i cursori di risposta disponibili, rimuove gli ID di commento duplicati e si ferma al limite richiesto, alla fine della conversazione o al tetto di raccolta di 100 pagine.
Parametri della TikTok Comment Replies API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL di un video TikTok obbligatorio su tiktok.com, www.tiktok.com o m.tiktok.com con un percorso /video/{numeric_id}. |
comment_id | Obbligatorio | ID pubblico del commento obbligatorio e non vuoto, relativo al commento di primo livello selezionato nello stesso video. |
results_limit | Facoltativo | Numero massimo di risposte richieste per il commento; il valore predefinito è 100 e accetta numeri interi da 20 a 2.000. |
Come usare la TikTok Comment Replies API
Parti dall’ID di un commento di primo livello di un video TikTok, invia un’attività asincrona per le risposte, poi leggi i record normalizzati con la paginazione a cursore dei risultati.
- Esegui TikTok Comments API per il video e scegli l’id del commento di primo livello di cui ti servono le risposte.
- Invia con POST lo stesso url del video, quel comment_id e un results_limit facoltativo a /v1/tiktok/comment-replies.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
- Leggi data.results.items da /v1/tasks/{task_id}?limit=50 e passa results.next_cursor finché results.has_more è true.
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.Casi d’uso della TikTok Comment Replies API
- Ricostruzione del ramo di un commento noto: Combina gli ID delle risposte, extra.parent_comment_id ed extra.input_url per ricostruire il ramo pubblico di risposte sotto un commento di primo livello selezionato.
- Revisione delle risposte a livello di singola replica: Usa testo delle risposte, timestamp, Mi piace visibili e numero di risposte per esaminare e confrontare le repliche pubbliche all’interno di una conversazione mirata.
- Mappatura dei partecipanti alla conversazione: Usa ID pubblici degli autori, nomi utente, link ai profili, avatar e flag dell’account per mappare i partecipanti presenti nel feed di risposte restituito.
Consigli degli esperti per la TikTok Comment Replies API
- Prendi comment_id dall’id normalizzato di un risultato di primo livello di TikTok Comments e riusa l’URL del video di quel risultato; l’ID di un video non è l’ID di un commento.
- Convalida l’host dell’URL e il percorso numerico /video/ prima dell’invio, così i link abbreviati, i profili o gli URL che non sono video non falliscono il controllo dell’input.
- Imposta results_limit sul volume di risposte che ti serve, tenendo presente che la conversazione pubblica può finire prima del limite e che la raccolta si ferma dopo 100 pagine della fonte.
- Quando combini più attività, deduplica per id della risposta e conserva extra.parent_comment_id ed extra.input_url, così le risposte restano legate alla conversazione corretta.
- Tratta testo delle risposte, campi dell’autore, metriche, menzioni e timestamp come campi nulli e applica l’escape al testo generato dagli utenti prima di mostrarlo negli strumenti a valle.
API correlate
Oltre alla TikTok Comment Replies API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok.
- TikTok Profiles API — Recupera identità del profilo pubblico, bio, flag dell’account e conteggi del pubblico a partire dal nome utente.
- TikTok Hashtags API — Raccoglie video pubblici, creator, media, suoni ed engagement per gli hashtag indicati.
- TikTok Comments API — Raccoglie i commenti pubblici di primo livello, autori, engagement, menzioni e flag di interazione del creator.
- TikTok Videos API — Recupera creator, didascalia, media, musica, tag, menzioni ed engagement dagli URL dei video.
- TikTok Search API — Cerca video pubblici per parola chiave con ordinamento e filtri di pubblicazione supportati.
- TikTok Comment Keywords API — Trova le parole chiave più ricorrenti nei commenti di un video, insieme ai commenti da cui provengono.
- 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