Toucora RAG e agentes de IA
Alimente embeddings, bancos vetoriais e pipelines LLM com transcrições limpas e com carimbos de tempo, sem raspar legendas você mesmo.
Infraestrutura para desenvolvedores
A API de transcrição do YouTube que os desenvolvedores realmente querem
Uma API REST para transcrições estruturadas de vídeos, playlists e canais públicos do YouTube. Créditos previsíveis, saída legível por máquina e erros claros. Grátis para começar.
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 }
]
}
Todos os formatos que você precisa
Peça o formato que você já usa. As respostas são estáveis e com carimbos de tempo, então suas ferramentas nunca adivinham.
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
Feita para cargas reais de transcrição
Pesquisa e análise
Extraia transcrições de uma playlist ou de um canal inteiro em um trabalho e analise temas, sentimento ou tempo de fala.
Legendas e acessibilidade
Exporte SRT, VTT ou texto simples para publicar legendas, criar um acervo acessível ou transformar vídeo em artigos.
Automação e ferramentas
Conecte transcrições a servidores MCP, Claude Code e Codex para que seus agentes leiam qualquer vídeo sob demanda.
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.
Perguntas frequentes
Existe uma API de transcrição do YouTube grátis?
Sim. Cada conta recebe 10.000 créditos grátis e uma chave de desenvolvedor, sem cartão. Cada vídeo custa um crédito, então você desenvolve e testa sem pagar.
Como obtenho uma transcrição do YouTube com uma API?
Chame GET /v1/transcripts/{videoId} com sua chave no cabeçalho Authorization. Você recebe a transcrição, o idioma, a duração e os segmentos com carimbos de tempo em JSON.
A API suporta legendas em outros idiomas?
Sim. Liste as faixas com GET /v1/transcripts/{videoId}/languages e passe ?lang= para a desejada. Legendas automáticas são rotuladas.
Quais formatos de saída a API retorna?
JSON, TXT, SRT, VTT e Markdown. Use ?format= nos pedidos de transcrição, ou converta o JSON: os segmentos são texto com início e duração.
Existe um exemplo em Python?
Sim. Algumas linhas com requests ou httpx bastam — veja o guia do blog para um início rápido em Python, com lotes e tentativas.
Posso obter uma playlist ou canal inteiro?
Sim. Envie até 50 IDs para POST /v1/transcripts, ou inicie um trabalho de playlist ou canal que retorna um resultado por vídeo com status individual.
Existe um servidor MCP para transcrições do YouTube?
Sim. Um servidor MCP expõe ferramentas de transcrição ao Claude Code, Codex e outros clientes MCP, para um agente ler um vídeo sem código próprio.
Quanto custa?
A API é grátis no acesso antecipado: 10.000 créditos por conta e 60 requisições/minuto. Planos pagos com limites maiores chegam em breve.
Comece a construir com transcrições hoje
Crie uma chave de desenvolvedor grátis, faça sua primeira requisição em um minuto e entregue transcrições que seus usuários possam buscar, citar e exportar.