youtube/
transcripts

Recupera le trascrizioni disponibili dagli URL dei video YouTube con una lingua facoltativa, con testo normalizzato, lingua e origine dei sottotitoli, contesto del canale e durata.

YouTube Transcripts API

Trascrizioni
Testo semplice
Lingua preferita
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

YouTube Transcripts

Le trascrizioni di YouTube sono versioni in testo semplice dei sottotitoli disponibili per i video pubblici, con lingua, origine dei sottotitoli, contesto del canale, dettagli di pubblicazione e durata. Questo testo supporta accessibilità, ricerca, verifica delle citazioni, analisi degli argomenti, riassunto e indicizzazione dei contenuti.

Funzionalità della YouTube Transcripts API

  • Recupero di trascrizioni da più videoRecupera il testo delle trascrizioni disponibili da più URL di video pubblici in una sola richiesta.
  • Selezione della lingua preferitaRichiedi una lingua preferita con un codice BCP-47 valido come en o zh-CN.
  • Metadati sulla disponibilità delle lingueRestituisce la lingua effettivamente selezionata e l’elenco delle lingue di trascrizione disponibili.
  • Formato di trascrizione in testo sempliceFornisce un formato coerente in testo semplice con le informazioni sull’origine della trascrizione, quando note.
  • Contesto del video tracciabileCollega ogni trascrizione a ID del video, titolo, informazioni sul canale, data di pubblicazione, durata e collected_at.

Parametri della YouTube Transcripts API

ParametriObbligatorioDescrizione
urlsObbligatorioURL di video YouTube pubblici, separati da virgole o da a capo.
languageFacoltativoLingua preferita facoltativa dei sottotitoli in formato BCP-47, come en o zh-CN; la lingua restituita può essere diversa.

Come usare la YouTube Transcripts API

Richiedi i sottotitoli solo dopo aver scelto i video che contano. Poi verifica la lingua e l’origine restituite prima che il testo entri in flussi di lavoro di ricerca, RAG, riassunto, traduzione o conformità.

  1. Scegli gli URL dei video pubblici, idealmente dopo che la scoperta o la revisione dei metadati ha eliminato gli elementi irrilevanti.
  2. Invia con POST urls e una language BCP-47 facoltativa a /v1/youtube/transcripts e memorizza il task_id.
  3. Interroga /v1/tasks/{task_id}; un batch riuscito può comunque contenere meno risultati degli URL inviati.
  4. Per ogni elemento, controlla language, available_languages e transcript_source prima di suddividere in blocchi il testo semplice; scorri le pagine finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/transcripts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"],"language":"en"}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casi d’uso della YouTube Transcripts API

  • Riassunto dei video: Usa il testo delle trascrizioni disponibili per creare riassunti, appunti di ricerca o brief dei contenuti per i video lunghi.
  • Archivi di video ricercabili: Indicizza il testo delle trascrizioni con ID dei video, titoli, informazioni sul canale e metadati della lingua.
  • Estrazione di argomenti e informazioni: Individua argomenti, entità, affermazioni e parole chiave in una raccolta selezionata di video pubblici.
  • Traduzione e localizzazione: Usa i campi della lingua selezionata e di quelle disponibili per instradare il testo delle trascrizioni verso flussi di lavoro di traduzione.

Consigli degli esperti per la YouTube Transcripts API

  • Instrada sempre in base alla lingua restituita, non alla preferenza richiesta. L’alternativa di riserva può legittimamente selezionare un’altra traccia disponibile.
  • I sottotitoli generati automaticamente possono contenere errori di nomi, punteggiatura e termini di settore. Conserva transcript_source e confronta con il video gli estratti più delicati.
  • Un’attività riuscita con meno elementi di solito significa che alcuni video non avevano sottotitoli pubblici utilizzabili; non è automaticamente un errore dell’intero batch.
  • Il testo semplice non ha timestamp dei segmenti né etichette degli interlocutori. Non ricavare da questa risposta tempi precisi per le citazioni.
  • Suddividi il testo in blocchi a valle, ma mantieni ID del video, lingua, origine e collected_at su ogni blocco, così le citazioni restano tracciabili.
  • Usa Videos per arricchire titolo, contenuti multimediali e metriche pubbliche quando la trascrizione comparirà in un catalogo ricercabile.
  • Se la copertura esatta della lingua è obbligatoria, confronta prima available_languages e considera i risultati di riserva come eccezioni da rivedere.

Oltre alla YouTube Transcripts API, usa queste API quando ti serve un altro tipo di dati pubblici di YouTube.

  • YouTube Channel Videos API — Raccoglie i video pubblici regolari dagli URL dei canali, esclusi Shorts e dirette.
  • YouTube Comments API — Raccoglie commenti pubblici, autori, engagement, video di origine e contesto della conversazione.
  • YouTube Channels API — Recupera identità del canale pubblico, immagini, verifica e statistiche visibili del pubblico.
  • YouTube Videos API — Recupera metadati, miniature, durata ed engagement a partire dagli URL di video o Short noti.
  • YouTube Shorts API — Raccoglie Shorts pubblici, miniature, durata, dettagli di pubblicazione ed engagement per canale.
  • YouTube Channel Live Videos API — Raccoglie i record pubblici delle trasmissioni presenti nelle sezioni live dei canali, con contesto della fonte e metriche visibili.

Esplora altre piattaforme

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

YouTube Transcripts API — FAQ

YouTube Transcripts API recupera il testo dei sottotitoli disponibili dagli URL di video YouTube pubblici, con una lingua preferita facoltativa. Restituisce testo semplice normalizzato, lingua effettiva e lingue disponibili, origine dei sottotitoli, contesto del video, durata e momento della raccolta.

Invia uno o più URL di video YouTube pubblici e una lingua preferita facoltativa in formato BCP-47.

Puoi richiedere una lingua preferita. Se non è disponibile una corrispondenza esatta, l’API può selezionare la lingua di base o un’altra trascrizione disponibile. Leggi sempre il campo language restituito.

Un video senza sottotitoli pubblici o testo di trascrizione disponibili non produce alcun risultato di trascrizione.

No. Il formato della risposta è testo semplice e non include timestamp dei segmenti né etichette degli interlocutori garantite.

No. L’accuratezza dipende dal fatto che i sottotitoli siano forniti da chi ha creato il video o generati automaticamente, oltre che da qualità dell’audio, lingua e interlocutori.

L’utilizzo costa 0,5 crediti per ogni risultato di trascrizione normalizzato restituito.