YouTube Transcripts
Las transcripciones de YouTube son versiones en texto plano de los subtítulos disponibles de videos públicos, con idioma, origen de los subtítulos, contexto del canal, datos de publicación y duración. Este texto sirve para accesibilidad, búsqueda, revisión de citas, análisis de temas, resumen e indexación de contenido.
Funcionalidades de la YouTube Transcripts API
- Obtención de transcripciones de varios videosObtiene el texto de transcripción disponible de varias URL de videos públicos en una sola solicitud.
- Selección del idioma preferidoPermite solicitar un idioma preferido con un código BCP-47 válido, como en o zh-CN.
- Metadatos de disponibilidad de idiomasDevuelve el idioma realmente seleccionado y la lista de idiomas de transcripción disponibles.
- Formato de transcripción en texto planoOfrece un formato de texto plano consistente con la información del origen de la transcripción cuando se conoce.
- Contexto del video con trazabilidadVincula cada transcripción con el ID del video, el título, la información del canal, la fecha de publicación, la duración y collected_at.
Parámetros de la YouTube Transcripts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL públicas de videos de YouTube, separadas por comas o saltos de línea. |
language | Opcional | Idioma preferido opcional de los subtítulos en formato BCP-47, como en o zh-CN; el idioma devuelto puede ser distinto. |
Cómo usar la YouTube Transcripts API
Solicite los subtítulos solo después de elegir los videos que importan. Luego verifique el idioma y el origen devueltos antes de que el texto entre en flujos de búsqueda, RAG, resumen, traducción o cumplimiento.
- Elija URL de videos públicos, idealmente después de que el descubrimiento o la revisión de metadatos haya descartado los elementos irrelevantes.
- Envíe por POST urls y, de forma opcional, un language BCP-47 a /v1/youtube/transcripts y almacene el task_id.
- Consulte /v1/tasks/{task_id}; un lote exitoso aún puede contener menos resultados que URL enviadas.
- Para cada elemento, revise language, available_languages y transcript_source antes de dividir el texto plano en fragmentos; pagine mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/transcripts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"],"language":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Casos de uso de la YouTube Transcripts API
- Resumen de videos: Use el texto de transcripción disponible para crear resúmenes, notas de investigación o fichas de contenido de videos largos.
- Archivos de videos con búsqueda: Indexe el texto de las transcripciones junto con los IDs de video, los títulos, la información del canal y los metadatos de idioma.
- Extracción de temas e información: Identifique temas, entidades, afirmaciones y palabras clave en una colección seleccionada de videos públicos.
- Traducción y localización: Use los campos de idioma seleccionado y disponible para enviar el texto de las transcripciones a flujos de traducción.
Consejos de expertos para la YouTube Transcripts API
- Dirija siempre el flujo según el idioma devuelto, no según el solicitado. La alternativa de respaldo puede seleccionar legítimamente otra pista disponible.
- Los subtítulos generados automáticamente pueden contener errores en nombres, puntuación y términos especializados. Conserve transcript_source y revise los extractos importantes contra el video.
- Una tarea exitosa con menos elementos suele significar que algunos videos no tenían subtítulos públicos utilizables; no es automáticamente un fallo del lote.
- El texto plano no tiene marcas de tiempo por segmento ni etiquetas de hablantes. No invente tiempos precisos de citas a partir de esta respuesta.
- Divida el texto en fragmentos en etapas posteriores, pero conserve el ID del video, el idioma, el origen y collected_at en cada fragmento para que las citas sigan siendo trazables.
- Use Videos para enriquecer el título, los medios y las métricas públicas cuando la transcripción vaya a aparecer en un catálogo con búsqueda.
- Si la cobertura exacta de idiomas es obligatoria, compare primero available_languages y trate los resultados con alternativa de respaldo como excepciones que requieren revisión.
APIs relacionadas
Además de la YouTube Transcripts API, use estas APIs cuando necesite otro tipo de datos públicos de YouTube.
- YouTube Channel Videos API — Recolecta videos públicos regulares desde URLs de canales, sin incluir Shorts ni transmisiones en vivo.
- YouTube Comments API — Recolecta comentarios públicos, autores, interacción, videos de origen y contexto de la conversación.
- YouTube Channels API — Obtiene la identidad del canal público, imágenes, verificación y estadísticas visibles de audiencia.
- YouTube Videos API — Obtiene metadatos, miniaturas, duración e interacción desde URLs conocidas de videos o Shorts.
- YouTube Shorts API — Recolecta Shorts públicos por canal, con miniaturas, duración, datos de publicación e interacción.
- YouTube Channel Live Videos API — Recolecta registros de transmisiones públicas expuestas en las secciones en vivo de un canal, con contexto de origen y métricas visibles.
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API