tiktok/
comment-replies

Raccogli le risposte pubbliche di TikTok a un commento a partire dall’URL del video e dall’ID del commento, con testo, autori, timestamp, engagement e contesto del commento padre come record normalizzati.

TikTok Comment Replies API

Risposte a un commento noto
Contesto dell’autore
Riferimento al commento padre
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlObbligatorioURL di un video TikTok obbligatorio su tiktok.com, www.tiktok.com o m.tiktok.com con un percorso /video/{numeric_id}.
comment_idObbligatorioID pubblico del commento obbligatorio e non vuoto, relativo al commento di primo livello selezionato nello stesso video.
results_limitFacoltativoNumero 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.

  1. Esegui TikTok Comments API per il video e scegli l’id del commento di primo livello di cui ti servono le risposte.
  2. Invia con POST lo stesso url del video, quel comment_id e un results_limit facoltativo a /v1/tiktok/comment-replies.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
  4. 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.

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.

Esplora altre piattaforme

Combina i dati di TikTok con i dati pubblici delle altre piattaforme social supportate.

TikTok Comment Replies API — FAQ

TikTok Comment Replies API è un’interfaccia programmatica per raccogliere le risposte pubbliche sotto un commento noto di un video TikTok, a partire dall’URL del video e dall’ID del commento. Restituisce testo delle risposte, identità dell’autore, timestamp, engagement visibile e contesto del commento padre, in forma normalizzata.

Esegui TikTok Comments API per lo stesso video e usa l’id normalizzato del commento di primo livello selezionato. Tieni quell’id abbinato all’URL del video di origine quando invii l’attività per le risposte.

Usa un URL su tiktok.com, www.tiktok.com o m.tiktok.com il cui percorso contiene /video/ seguito da un ID video numerico. Un link abbreviato, l’URL di un profilo o l’URL di un video senza un comment_id non vuoto non soddisfa la specifica della richiesta.

Un record può contenere ID e testo della risposta, URL del video di origine, identità pubblica dell’autore e flag dell’account, numero di Mi piace e di risposte, menzioni, created_at, collected_at, extra.parent_comment_id ed extra.input_url.

results_limit è un massimo e non una garanzia. La raccolta può concludersi quando il feed pubblico delle risposte termina, non vengono restituiti nuovi ID di risposta unici, il feed smette di far avanzare il cursore o si raggiunge il tetto di 100 pagine.

Ogni risposta normalizzata salvata costa 0,5 crediti, senza costo base per l’attività. La stima iniziale usa results_limit o il suo valore predefinito di 100, mentre l’utilizzo finale segue i record effettivamente salvati; nessuna risposta salvata significa nessun addebito.