youtube/
transcripts

Obtenga las transcripciones disponibles de URL de videos de YouTube con un idioma opcional, con texto normalizado, idioma y origen de los subtítulos, contexto del canal y duración.

YouTube Transcripts API

Transcripciones
Texto plano
Idioma preferido
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioURL públicas de videos de YouTube, separadas por comas o saltos de línea.
languageOpcionalIdioma 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.

  1. Elija URL de videos públicos, idealmente después de que el descubrimiento o la revisión de metadatos haya descartado los elementos irrelevantes.
  2. Envíe por POST urls y, de forma opcional, un language BCP-47 a /v1/youtube/transcripts y almacene el task_id.
  3. Consulte /v1/tasks/{task_id}; un lote exitoso aún puede contener menos resultados que URL enviadas.
  4. 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=50

Casos 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.

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.

Explorar otras plataformas

Combine los datos de YouTube con datos públicos de otras plataformas sociales compatibles.

YouTube Transcripts API — FAQ

YouTube Transcripts API obtiene el texto de subtítulos disponible de URL públicas de videos de YouTube con un idioma preferido opcional. Devuelve texto plano normalizado, idioma real e idiomas disponibles, origen de los subtítulos, contexto del video, duración y hora de recopilación.

Envíe una o más URL públicas de videos de YouTube y, de forma opcional, un idioma preferido en formato BCP-47.

Puede solicitar un idioma preferido. Si no hay una coincidencia exacta, la API puede seleccionar el idioma base u otra transcripción disponible. Lea siempre el campo language devuelto.

Un video sin subtítulos públicos ni texto de transcripción disponibles no genera un resultado de transcripción.

No. El formato de la respuesta es texto plano y no incluye marcas de tiempo por segmento ni etiquetas de hablantes garantizadas.

No. La precisión depende de si los subtítulos los proporcionó el creador o se generaron automáticamente, así como de la calidad del audio, el idioma y los hablantes.

El uso cuesta 0.5 créditos por cada resultado de transcripción normalizado devuelto.