tiktok/
video-transcript

Estrai le trascrizioni dagli URL di video pubblici di TikTok con una lingua facoltativa, con testo, lingua, formato, link di origine e orario di raccolta come record normalizzati.

TikTok Video Transcript API

Trascrizione del video
Lingua facoltativa
Testo semplice o WebVTT
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 Video Transcript

I record di TikTok Video Transcript contengono il parlato o i sottotitoli disponibili dei video pubblici, con lingua, formato in testo semplice o WebVTT, URL di origine, shortcode e orario di raccolta. Questi record supportano la ricerca nei contenuti parlati, l’analisi di parole chiave e argomenti, la revisione dell’accessibilità e la ricerca di citazioni collegate alla fonte.

Funzionalità della TikTok Video Transcript API

  • Trascrizione da più URLElabora uno o più URL di video pubblici di TikTok in una sola attività e passa una preferenza di lingua facoltativa con ogni ricerca.
  • Testo normalizzato e provenienzaRestituisce il testo della trascrizione con lingua, formato in testo semplice o WebVTT, URL di origine, ID del record, shortcode e orario di raccolta in una struttura coerente.
  • Solo record disponibiliEmette un risultato solo quando una fonte restituisce un testo di trascrizione non vuoto, così la risposta distingue le trascrizioni disponibili senza righe segnaposto.

Parametri della TikTok Video Transcript API

ParametriObbligatorioDescrizione
urlsObbligatorioUno o più URL di video pubblici di TikTok risolvibili, separati da virgole o da a capo.
languageFacoltativoLingua preferita facoltativa della trascrizione; usa un codice di due lettere come en, es o fr.

Come usare la TikTok Video Transcript API

Invia URL noti di video pubblici di TikTok come attività asincrona, interroga il relativo ID attività, poi riconcilia i record di trascrizione normalizzati con le fonti richieste.

  1. Prepara uno o più URL di video pubblici di TikTok risolvibili e, se serve, un codice lingua di due lettere come en.
  2. Invia con POST urls e la lingua facoltativa a /v1/tiktok/video-transcript, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed; un’attività riuscita può comunque contenere meno record degli URL inviati.
  4. Leggi data.results.items, associa ogni url all’insieme di input e segui results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok/video-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"],"language":"en"}'

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

Casi d’uso della TikTok Video Transcript API

  • Archivi ricercabili dei contenuti parlati: Indicizza il testo delle trascrizioni con URL di origine, lingua, formato, shortcode e orario di raccolta, così i video pubblici selezionati possono essere cercati per termini parlati.
  • Analisi di parole chiave e argomenti: Analizza il testo normalizzato di un insieme noto di video per individuare parole, frasi e temi ricorrenti, conservando il link di origine per la revisione.
  • Revisione di accessibilità e citazioni: Usa il testo disponibile delle trascrizioni e i metadati del formato per preparare copie leggibili o trovare passaggi, poi verificali sul video pubblico collegato.

Consigli degli esperti per la TikTok Video Transcript API

  • Verifica che ogni destinazione corrisponda al video pubblico di TikTok previsto prima dell’invio, perché la richiesta accetta stringhe URL non vuote senza imporre l’host di TikTok o il percorso /video/{id}.
  • Rendi canonici gli URL e rimuovi le varianti di tracciamento prima di creare i batch, perché la rimozione degli spazi e la deduplicazione eliminano solo le stringhe inviate identiche.
  • Quando scegli una lingua, usa un codice di due lettere come en e instrada l’elaborazione successiva in base al campo language restituito, senza dare per scontato che la preferenza sia stata soddisfatta.
  • Dopo un’attività riuscita, confronta i valori url restituiti con l’elenco inviato, così i video non disponibili, privati, eliminati, limitati, senza sottotitoli o senza parlato restano visibili nel tuo flusso di lavoro.
  • Differenzia l’analisi in base a format, conserva i cue WebVTT quando presenti e usa collected_at per la tracciabilità, perché created_at non contiene l’ora di pubblicazione del video.

Oltre alla TikTok Video Transcript 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 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 User Videos API — Raccoglie i video pubblici del feed di un profilo a partire dal nome utente con didascalie, creator, media, date, engagement e contesto dell’account di origine.
  • TikTok Trending Feed API — Raccoglie il feed video pubblico attuale di una regione con creator, didascalia, copertina, data ed engagement visibile.
  • TikTok Song API — Recupera i metadati di un suono pubblico tramite ID della clip o URL del brano.

Esplora altre piattaforme

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

TikTok Video Transcript API — FAQ

TikTok Video Transcript API è un’interfaccia programmatica per estrarre il testo disponibile delle trascrizioni da uno o più URL di video pubblici di TikTok con una preferenza di lingua facoltativa. Restituisce testo normalizzato, lingua, formato in testo semplice o WebVTT, URL di origine, shortcode e orario di raccolta quando è disponibile un testo di trascrizione non vuoto.

Invia un array urls non vuoto e, se vuoi, una stringa language. L’endpoint non accetta results_limit, usernames, query di ricerca, impostazioni di download dei media né un’opzione di alternativa di riserva con AI.

Ogni record include id, platform, resource, type, url, text, language nullable, format, created_at, collected_at ed extra.shortcode. Non conserva descrizioni dei video, autori, metriche di engagement, immagini di copertina, URL di download né oggetti con segmenti temporizzati.

Un record viene creato solo quando la fonte restituisce un testo di trascrizione non vuoto. I video senza parlato o sottotitoli accessibili, e le destinazioni private, eliminate, limitate o non disponibili, possono quindi non lasciare alcuna riga segnaposto.

No. Usa una preferenza di due lettere come en, es o fr, poi controlla il campo language restituito; la disponibilità delle lingue e l’accuratezza della trascrizione dipendono dalla fonte accessibile.

L’utilizzo costa 0,5 crediti per ogni record di trascrizione normalizzato restituito, senza costo di base. Un URL di input che non produce alcun record non comporta alcun costo per risultato secondo l’attuale policy sui risultati vuoti.