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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Uno o più URL di video pubblici di TikTok risolvibili, separati da virgole o da a capo. |
language | Facoltativo | Lingua 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.
- Prepara uno o più URL di video pubblici di TikTok risolvibili e, se serve, un codice lingua di due lettere come en.
- Invia con POST urls e la lingua facoltativa a /v1/tiktok/video-transcript, poi salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed; un’attività riuscita può comunque contenere meno record degli URL inviati.
- 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 trueCasi 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.
API correlate
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.
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users 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
- TikTok Comment Keywords API