Toucora Python
API di trascrizione YouTube in Python: quickstart in 5 minuti
Ottieni trascrizioni YouTube in Python con poche righe di requests o httpx. Include batching, scelta della lingua, gestione degli errori e retry con l’API Toucora.
Dal team Toucora · 2026-09-29 · 7 min di lettura
Una richiesta, una trascrizione
La via più breve è un GET a /v1/transcripts/{videoId} con la chiave nell’header Authorization. La risposta è JSON: id del video, lingua, durata ed elenco di segmenti. Nessun SDK richiesto — basta requests o httpx.
Scegliere lingua e formato
Chiama prima /v1/transcripts/{videoId}/languages se il video può essere multilingue, scegli la traccia e passa ?lang= e ?format=. srt o vtt restituiscono sottotitoli pronti da salvare; json mantiene i segmenti strutturati.
Batching e retry
Per elenchi, invia fino a 50 id a /v1/transcripts in una chiamata e leggi i risultati per elemento. Aggiungi timeout e un piccolo backoff esponenziale: guasti transitori e 429 si risolvono in fretta, e ogni risposta porta un X-Request-ID da registrare.
Gestire i casi difficili
Alcuni video non hanno sottotitoli, altri sono privati o bloccati per regione. L’API risponde con un codice tipizzato e un messaggio leggibile, così il tuo codice decide sul codice e non sulla prosa. Registra il request id: è la via più rapida a una correzione.
Domande frequenti
Serve un SDK?
No. Qualsiasi client HTTP va bene. Un sottile wrapper su requests basta per la maggior parte dei progetti.
Come faccio il batching di molti video?
Invia fino a 50 id a POST /v1/transcripts; insiemi più grandi vanno in un job playlist o canale.
E Python asincrono?
Usa httpx.AsyncClient con gli stessi endpoint e un semaforo limitato per la concorrenza.
Continua a leggere
Prova l’API su un video
Crea una chiave sviluppatore gratuita e ottieni la tua prima trascrizione in un minuto.
Ottieni una chiave API →