Toucora API
🌐 Idioma
Infraestructura para desarrolladores

La API de transcripciones de YouTube que los desarrolladores quieren

Una API REST para transcripciones estructuradas de vídeos, listas y canales públicos de YouTube. Créditos predecibles, salida legible por máquinas y errores claros. Gratis para empezar.

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 los formatos que necesitas

Pide el formato que ya usas. Las respuestas son estables y con marcas de tiempo, así que tus herramientas nunca adivinan.

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

Creada para cargas reales de transcripciones

RAG y agentes de IA

Alimenta embeddings, bases vectoriales y pipelines LLM con transcripciones limpias y con marcas de tiempo, sin rastrear subtítulos tú mismo.

Investigación y analítica

Extrae transcripciones de una lista o de un canal entero en un solo trabajo y analiza temas, sentimiento o tiempo de habla.

Subtítulos y accesibilidad

Exporta SRT, VTT o texto plano para publicar subtítulos, crear un archivo accesible o convertir vídeo en artículos.

Automatización y herramientas

Conecta transcripciones a servidores MCP, Claude Code y Codex para que tus agentes lean cualquier vídeo a demanda.

Pricing

Free for a limited time

10,000 credits free for any account — no credit card, no signup wall to try.

Paid plans are coming soon. While the API is in early access, everything is included at no cost.

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.

Preguntas frecuentes

¿Existe una API de transcripciones de YouTube gratis?

Sí. Cada cuenta recibe 10.000 créditos gratis y una clave de desarrollador, sin tarjeta. Cada vídeo cuesta un crédito, así que puedes desarrollar y probar sin pagar.

¿Cómo obtengo una transcripción de YouTube con una API?

Llama a GET /v1/transcripts/{videoId} con tu clave en la cabecera Authorization. Recibes la transcripción, su idioma, duración y segmentos con marcas de tiempo en JSON.

¿La API admite subtítulos en otros idiomas?

Sí. Lista las pistas con GET /v1/transcripts/{videoId}/languages y pasa ?lang= para obtener la que quieras. Los subtítulos automáticos se etiquetan para que conozcas su calidad.

¿Qué formatos de salida devuelve la API?

JSON, TXT, SRT, VTT y Markdown. Usa ?format= en las peticiones de transcripción, o convierte el JSON tú mismo: los segmentos son texto con inicio y duración.

¿Hay un ejemplo en Python?

Sí. Bastan unas líneas con requests o httpx; consulta la guía del blog para un inicio rápido en Python, con lotes y reintentos.

¿Puedo obtener una lista o un canal completo?

Sí. Envía hasta 50 IDs con POST /v1/transcripts, o inicia un trabajo de lista o canal que devuelve un resultado por vídeo con estado individual.

¿Hay un servidor MCP para transcripciones de YouTube?

Sí. Un servidor MCP expone herramientas de transcripción a Claude Code, Codex y otros clientes MCP, para que un agente lea un vídeo sin código a medida.

¿Cuánto cuesta?

La API es gratis durante el acceso anticipado: 10.000 créditos por cuenta y 60 peticiones/minuto. Los planes de pago con límites mayores llegarán pronto.

Empieza a crear con transcripciones hoy

Crea una clave de desarrollador gratis, haz tu primera petición en un minuto y entrega transcripciones que tus usuarios puedan buscar, citar y exportar.