Toucora RAG e agenti AI
Alimenta embeddings, database vettoriali e pipeline LLM con trascrizioni pulite e con timestamp, senza scrapare i sottotitoli da solo.
Infrastruttura per sviluppatori
L’API di trascrizione YouTube che gli sviluppatori vogliono davvero
Una API REST per trascrizioni strutturate di video, playlist e canali pubblici di YouTube. Crediti prevedibili, output leggibile dalle macchine ed errori chiari. Gratis per iniziare.
Request
# quickstart.sh curl "https://api.example.com/v1/transcripts/VIDEO_ID" \ -H "Authorization: Bearer YOUR_API_KEY"
200 OK
{
"video_id": "dQw4w9WgXcQ",
"language": "en",
"duration": 213,
"segments": [
{ "text": "...", "start": 18.64, "duration": 3.24 }
]
}
Tutti i formati che ti servono
Chiedi il formato che già usi. Le risposte sono stabili e con timestamp, così gli strumenti a valle non tirano a indovinare.
Transcripts
Single video, batch up to 50, playlists and channels. JSON, TXT, SRT, VTT, Markdown.
GET /v1/transcripts/{videoId}
Jobs & webhooks
Large requests become asynchronous jobs with per-item status, retries and webhooks.
POST /v1/jobs
AI endpoints
Grounded answers with timestamps, summaries and chapters. Small and focused at launch.
POST /v1/ask
Pensata per carichi di trascrizione reali
Ricerca e analisi
Estrai le trascrizioni di una playlist o di un intero canale in un solo job, poi analizza temi, sentiment o tempo di parola.
Sottotitoli e accessibilità
Esporta SRT, VTT o testo semplice per pubblicare sottotitoli, costruire un archivio accessibile o trasformare il video in articoli.
Automazione e strumenti
Collega le trascrizioni a server MCP, Claude Code e Codex così i tuoi agenti leggono qualsiasi video su richiesta.
Pricing
Limits are configuration-driven and may change as the API stabilises.
Authentication
Authorization: Bearer YOUR_API_KEY
# or
X-API-Key: YOUR_API_KEY
Keys are hashed at rest, shown once, revocable, and scoped per account.
Errors you can handle
{
"error": {
"code": "TRANSCRIPT_NOT_AVAILABLE",
"message": "...",
"request_id": "req_123"
}
}
Every request carries an X-Request-ID for support and debugging.
OpenAPI
The canonical schema is published and importable into Postman and other tooling.
Domande frequenti
Esiste un’API gratuita per le trascrizioni di YouTube?
Sì. Ogni account riceve 10.000 crediti gratuiti e una chiave sviluppatore, senza carta. Un video costa un credito: puoi sviluppare e testare senza pagare.
Come ottengo una trascrizione da YouTube con un’API?
Chiama GET /v1/transcripts/{videoId} con la chiave nell’header Authorization. Ricevi trascrizione, lingua, durata e segmenti con timestamp in JSON.
L’API supporta sottotitoli in altre lingue?
Sì. Elenca le tracce con GET /v1/transcripts/{videoId}/languages, poi passa ?lang= per quella desiderata. I sottotitoli automatici sono etichettati.
Quali formati di output restituisce l’API?
JSON, TXT, SRT, VTT e Markdown. Usa ?format= nelle richieste di trascrizione, o converti il JSON: i segmenti sono testo con inizio e durata.
C’è un esempio in Python?
Sì. Bastano poche righe con requests o httpx — vedi la guida del blog per una quickstart in Python, con batching e retry.
Posso ottenere un’intera playlist o un canale?
Sì. Invia fino a 50 ID con POST /v1/transcripts, o avvia un job playlist o canale che restituisce un risultato per video con stato individuale.
Esiste un server MCP per le trascrizioni YouTube?
Sì. Un server MCP espone strumenti di trascrizione a Claude Code, Codex e altri client MCP, così un agente legge un video senza codice dedicato.
Quanto costa?
L’API è gratuita in accesso anticipato: 10.000 crediti per account e 60 richieste/minuto. I piani a pagamento con limiti più alti arrivano presto.
Inizia oggi a costruire con le trascrizioni
Crea una chiave sviluppatore gratuita, fai la prima richiesta in un minuto e offri trascrizioni che i tuoi utenti possono cercare, citare ed esportare.