tiktok/
comments

Raccogli i commenti pubblici di primo livello di TikTok da URL diretti di video, con testo normalizzato, autori, Mi piace, numero di risposte, menzioni e flag di interazione del creator.

TikTok Comments API

Voce del pubblico
Ricerca sui feedback
Priorità dei commenti
0,25 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 Comments

I commenti di TikTok sono risposte pubbliche ai video, con testo, contesto dell’autore, Mi piace visibili, numero di risposte, menzioni e segnali di interazione del creator. Queste conversazioni supportano l’analisi dei feedback del pubblico, la ricerca sui temi ricorrenti, la revisione del sentiment e il monitoraggio delle reazioni ai contenuti.

Funzionalità della TikTok Comments API

  • Raccolta di commenti da più videoRaccogli i commenti pubblici di primo livello da più URL diretti di video TikTok in una sola richiesta.
  • Record di commenti tracciabiliMantieni i feedback tracciabili tramite ID del commento, video di origine, autore e orario di pubblicazione.
  • Testo dei commenti e menzioniEstrai testo e menzioni dei commenti per l’analisi di argomenti, sentiment ed esigenze.
  • Segnali di interazione pubbliciIncludi in ogni record di commento i Mi piace visibili, il numero di risposte, lo stato di commento fissato e lo stato di Mi piace del creator.
  • Limiti di risultati per videoAssegna la dimensione del campione per ogni video tramite results_limit.

Parametri della TikTok Comments API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di URL diretti di video TikTok usati per raccogliere i commenti pubblici di primo livello.
results_limitFacoltativoLimite positivo richiesto di commenti di primo livello per ogni URL di video. Il valore predefinito è 100.

Come usare la TikTok Comments API

Scegli i video da studiare e la dimensione del campione di commenti per ciascuno, poi inizia a raccogliere i feedback del pubblico.

  1. Seleziona il campione di contenuti e pianifica un results_limit per ogni video.
  2. Invia con POST urls e results_limit a /v1/tiktok/comments e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività va a buon fine o fallisce.
  4. Leggi data.results.items. Quando has_more è true, continua con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della TikTok Comments API

  • Ricerca sulla voce del cliente: Individua esigenze, domande, apprezzamenti e suggerimenti ricorrenti nel linguaggio del pubblico.
  • Code di revisione delle discussioni: Usa testo dei commenti, Mi piace visibili e numero di risposte per organizzare i commenti da rivedere per assistenza, ricerca o ascolto.
  • Analisi della risposta ai contenuti creativi: Confronta le reazioni tra i video per individuare le idee che generano risonanza, dibattito o conversazione.
  • Revisione dell’interazione dei creator: Studia commenti fissati, Mi piace dei creator e numero di risposte per capire come i creator influenzano le proprie sezioni dei commenti.

Consigli degli esperti per la TikTok Comments API

  • Assegna results_limit in base all’importanza di ogni video, poi moltiplica per il numero di URL per stimare la dimensione del lotto.
  • Considera likes_count come riconoscimento e replies_count come profondità della discussione, in analisi separate.
  • Usa is_pinned e creator_liked come segnali dei feedback che il creator ha messo attivamente in evidenza.
  • Deduplica per id del commento e conserva l’URL del video e collected_at per avere una provenienza chiara.
  • Applica l’escape al testo dei commenti prima di inserirlo in dashboard, ticket o report e conserva il testo di origine per la revisione.
  • Usa i segnali di interazione per definire un ordine di revisione, poi classifica per tema o sentiment il testo originale dei commenti.

Oltre alla TikTok Comments 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 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 Replies API — Raccoglie le risposte pubbliche a un commento noto tramite l’URL del video TikTok e l’ID del commento, con autori, engagement, date e contesto del commento principale.
  • 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 Comments API — FAQ

TikTok Comments API raccoglie i commenti pubblici di primo livello visibili da URL diretti di video TikTok. Restituisce testo normalizzato, dettagli dell’autore, numero di Mi piace e di risposte, menzioni e flag di interazione del creator; il testo delle risposte non è incluso.

Invia uno o più URL diretti di video TikTok nell’array urls e usa results_limit per impostare il volume di commenti richiesto per ogni video.

Sì. urls accetta più link di video e la stessa attività asincrona elabora i commenti pubblici di primo livello di ciascun video.

results_limit si applica separatamente a ogni video inserito e ha come valore predefinito 100. Tre video con un valore di 100 richiedono fino a 100 commenti di primo livello per ciascun video.

I risultati includono ID del commento, testo, orario di pubblicazione, URL del video di origine e campi pubblici dell’autore come ID, nome utente, nome visualizzato, URL del profilo, avatar e stato di verifica.

I risultati possono includere Mi piace, numero di risposte, menzioni, stato di Mi piace del creator e stato di commento fissato, per l’analisi dell’interazione pubblica.

Ordina o filtra in base ai Mi piace visibili e al numero di risposte, poi usa lo stato di commento fissato e di Mi piace del creator come contesto aggiuntivo. Questi segnali descrivono l’interazione pubblica e da soli non determinano il sentiment dei commenti.

Ogni commento normalizzato restituito costa 0,25 crediti.