YouTube Transcript
Dale a tu agente las palabras de un video de YouTube
La API de transcripciones de YouTube de Frameskim devuelve la transcripción con timestamps de cada video público por $0.01 por transcripción, hasta 100 videos por ejecución. Envía hasta 100 URLs públicas de YouTube por ejecución. Recibe cada transcripción con timestamps por segmento y el texto completo, lista para pegar en un LLM.
US$0.01 por transcripción. Los videos que fallan no se cobran.
{
"videoId": "4czjS9h4Fpg",
"title": "Perseverance Rover's Descent and Touchdown on Mars",
"lang": "en",
"segments": [
{ "start": 0.0, "end": 4.2, "text": "..." }
],
"text": "...",
"frameskimUrl": "https://apify.com/emttn/frameskim"
}Valores acortados. segments lleva start y end en segundos; text es toda la transcripción en un solo texto; frameskimUrl apunta a Frameskim para los frames del mismo video.
Casos de uso
Resumir un video o preguntarle algo
Pega text en cualquier modelo y pide un resumen, los pasos de un tutorial o una respuesta.
Indexar un lote de videos
Envía una lista de hasta 100 URLs de video en una ejecución y carga las transcripciones en tu búsqueda o pipeline de RAG.
Citar el segundo exacto
Cada segmento tiene su inicio y su fin, así una respuesta puede enlazar al momento del que salió.
Entrada y salida
{
"urls": ["https://youtu.be/4czjS9h4Fpg"],
"lang": "en"
}lang es en por defecto y, si el video no la tiene, usa el idioma original del video.
{
"videoId": "abc123def45",
"error": "..."
}Sin subtítulos o bloqueado por YouTube: el ítem dice el motivo.
Precio
US$0.01 por transcripción
Pago por evento en Apify. Sin suscripción. Un lote de 100 videos con subtítulos cuesta US$1.00, y nunca más que el límite de gasto que pones para la ejecución.
Límites
- Videos, canales y playlists públicos, hasta 100 videos por ejecución; cada canal o playlist suma hasta maxVideos de sus videos (20 por defecto). Las búsquedas se rechazan antes de ejecutar nada, sin cobrar nada.
- Lo que falla no se cobra: sin subtítulos, bloqueado por YouTube o más de 120 s para un video.
- Los videos necesitan subtítulos: no transcribe audio.
- Ejemplo: las transcripciones de un canal entero en una ejecución
Úsalo por API o desde Claude
curl -X POST "https://api.apify.com/v2/acts/emttn~youtube-transcript/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://youtu.be/4czjS9h4Fpg"]}'{ "mcpServers": { "apify": {
"url": "https://mcp.apify.com/?actors=emttn/youtube-transcript"
} } }Después pide: "Usa YouTube Transcript para leer este video y resumirlo."
Preguntas frecuentes
¿Qué idiomas?
Cualquier idioma en el que el video tenga subtítulos; define lang (por defecto en) y el actor recurre al idioma original. Cuando el video no tiene una pista manual en el idioma pedido, puede devolverse en su lugar la traducción automática de YouTube de sus subtítulos; el campo lang de cada ítem dice qué idioma recibiste.
¿Qué pasa si una ejecución falla?
El mensaje de estado dice el motivo. Una ejecución que no puede empezar dice "Nothing was charged."; una que se detiene de forma inesperada dice "Only delivered transcripts were charged." y cobra solo las transcripciones que entregó, si hay alguna. Reintenta más tarde si YouTube bloqueó la solicitud. Si parece un error nuestro, comparte la ejecución con nosotros desde Apify Console o abre un issue en la pestaña Issues con el ID de la ejecución: solo vemos las ejecuciones que compartes.
¿Guardan mis transcripciones?
No. Viven solo en el almacenamiento de Apify de tu propia ejecución, con la retención de tu plan.
¿Por qué no la API oficial de YouTube Data?
Su método de descarga de subtítulos, captions.download, exige permiso para editar el video, un scope de OAuth y 200 unidades de cuota por llamada, así que sirve al dueño de un video, no a un tercero. Este actor lee los subtítulos de videos públicos y los devuelve como JSON: 17 de 20 videos públicos entregados en nuestra última medición (85%), y un video que no se puede leer se informa y no se cobra.
¿Alternativas para transcripciones de YouTube?
Puedes copiar los subtítulos a mano desde la página del video, o escribir tu propio extractor y mantenerlo funcionando mientras YouTube cambia. Este actor es la versión de pago por transcripción de eso; para frames y momentos de los mismos videos usa Frameskim, y para Reels y TikToks Instagram & TikTok Transcripts, Frames & Posts.