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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di video YouTube pubblici, separati da virgole o da a capo. |
language | Facoltativo | Lingua 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à.
- Scegli gli URL dei video pubblici, idealmente dopo che la scoperta o la revisione dei metadati ha eliminato gli elementi irrilevanti.
- Invia con POST urls e una language BCP-47 facoltativa a /v1/youtube/transcripts e memorizza il task_id.
- Interroga /v1/tasks/{task_id}; un batch riuscito può comunque contenere meno risultati degli URL inviati.
- 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=50Casi 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.
API correlate
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.
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API