youtube/
channel-live-videos

Recopile las transmisiones públicas de las secciones en vivo de canales de YouTube, con metadatos de video normalizados, contexto del canal, miniaturas, datos de publicación e interacción visible.

YouTube Channel Live Videos API

Sección en vivo del canal
Transmisiones públicas
Recopilación asíncrona
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 Channel Live Videos

Los videos en vivo de un canal de YouTube son entradas de transmisiones públicas que aparecen en la sección en vivo de un canal concreto, con identidad del video, contexto del canal, miniaturas, marcas de tiempo e interacción visible. Según lo que YouTube muestre para ese canal, la colección puede contener transmisiones actuales, programadas o archivadas, sin que se garantice una etiqueta normalizada del estado en vivo.

Funcionalidades de la YouTube Channel Live Videos API

  • Compatibilidad con URL canónicas de canalResuelve las URL públicas de YouTube con /@handle, /channel/{id}, /c/{name} y /user/{name}.
  • Descubrimiento en la sección en vivo del canalRecopila las entradas de transmisiones disponibles en la sección en vivo de cada canal enviado.
  • Profundidad de recopilación por canalPermite solicitar de 20 a 2,000 registros por cada canal de entrada, con un valor predeterminado de 100.
  • Registros de transmisión normalizadosDevuelve la identidad del video, el título, la descripción, el canal, la miniatura, la duración, los hashtags, la hora de publicación y el contexto de origen cuando están disponibles.
  • Instantáneas de interacción visibleCaptura las vistas, los Me gusta y los comentarios públicos junto con collected_at para analizar un momento concreto.
  • Entrega asíncrona de resultadosPermite consultar el estado de la tarea, conservar el ID de tarea y usar la paginación por cursor para obtener los resultados de forma asíncrona y confiable.

Parámetros de la YouTube Channel Live Videos API

ParámetrosObligatorioDescripción
urlsObligatorioURL públicas de canales de YouTube separadas por comas o saltos de línea. Las rutas compatibles son /@handle, /channel/{id}, /c/{name} y /user/{name}.
results_limitOpcionalCantidad máxima de registros solicitados por cada URL de canal. Debe ser un entero de 20 a 2,000 y su valor predeterminado es 100.

Cómo usar la YouTube Channel Live Videos API

Envíe URL canónicas de canales públicos y elija la profundidad de recopilación para cada una. La solicitud crea una tarea asíncrona, por lo que la finalización y la obtención de resultados son pasos separados.

  1. Prepare una o más URL públicas de canales de YouTube con una ruta compatible: handle, ID de canal, nombre personalizado o usuario.
  2. Envíe urls y results_limit por POST a /v1/youtube/channel-live-videos y conserve el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
  4. Lea las páginas de resultados desde /v1/tasks/{task_id}?limit=50 y devuelva next_cursor como cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/channel-live-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50&cursor={next_cursor}

Casos de uso de la YouTube Channel Live Videos API

  • Creación de inventarios de transmisiones: Cree una lista estructurada de las transmisiones públicas asociadas a los canales seleccionados.
  • Investigación de programación en vivo: Compare títulos, horarios, duración y patrones de publicación en canales con programación en vivo recurrente.
  • Monitoreo de transmisiones de creadores: Siga qué registros de transmisiones públicas están visibles en los canales de creadores, marcas, medios o competidores.
  • Instantáneas del rendimiento tras la transmisión: Almacene las vistas, los Me gusta y los comentarios visibles con la hora de recopilación para comparar tendencias más adelante.
  • Enriquecimiento de catálogos de medios públicos: Agregue metadatos de transmisiones normalizados y contexto del canal de origen a sistemas de búsqueda, informes o clasificación.

Consejos de expertos para la YouTube Channel Live Videos API

  • results_limit se aplica a cada canal. Cinco URL con un límite de 100 solicitan hasta 500 registros antes de la deduplicación de toda la tarea.
  • Use URL canónicas de canal con un handle, un ID de canal, un nombre personalizado o un nombre de usuario que no estén vacíos; una ruta /channel sin identificador no permite resolver el origen.
  • Considere la sección en vivo del canal como el límite de elegibilidad. La disponibilidad de transmisiones actuales, programadas y archivadas puede cambiar entre recopilaciones.
  • No deduzca un estado confiable de actual, programada o archivada a partir de type o extra.content_type; la carga normalizada no tiene un campo dedicado al estado en vivo.
  • La respuesta contiene metadatos y referencias a miniaturas, no el chat en vivo, una URL de transmisión reproducible, subtítulos ni el texto de la transcripción.
  • Entradas de canal equivalentes pueden descubrir el mismo video. Los resultados guardados de la tarea se deduplican por ID de video normalizado y, si no hay ID, por URL.
  • El límite de resultados de la tarea es independiente de results_limit: solicite de 1 a 500 filas guardadas por página y reutilice el next_cursor opaco hasta que has_more sea false.
  • Los metadatos públicos no permiten ver contenido privado ni exclusivo para miembros. Conserve extra.is_members_only cuando el origen informe esa clasificación.

Además de la YouTube Channel Live Videos 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 Transcripts API — Obtiene las transcripciones disponibles en texto plano, con selección de idioma opcional.
  • 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.

Explorar otras plataformas

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

YouTube Channel Live Videos API — FAQ

YouTube Channel Live Videos API recopila registros normalizados de transmisiones públicas que aparecen en las secciones en vivo de uno o más canales de YouTube. Devuelve la identidad del video y del canal, metadatos descriptivos, miniaturas, marcas de tiempo, interacción visible, contexto de entrada y hora de recopilación cuando están disponibles.

Use una URL pública de youtube.com con /@handle, /channel/{id}, /c/{name} o /user/{name}. El segmento del identificador no debe estar vacío.

No. La sección elegible del canal puede mostrar transmisiones actuales, programadas o archivadas, y la disponibilidad puede variar según el canal y el momento de la recopilación.

No. extra.content_type puede conservar una clasificación del origen cuando existe, pero no sustituye de forma confiable a un estado dedicado de actual, programada o archivada.

results_limit tiene un valor predeterminado de 100, acepta de 20 a 2,000 y se aplica por separado a cada URL de canal enviada. Las filas guardadas pueden ser menos por la disponibilidad del canal y la deduplicación de videos en toda la tarea.

No. El endpoint devuelve metadatos de transmisiones públicas y referencias a miniaturas; no devuelve mensajes del chat en vivo, archivos de transmisión reproducibles, subtítulos ni transcripciones.

La solicitud se estima a partir del número de URL de canal multiplicado por results_limit y luego se concilia a 0.5 créditos por cada resultado normalizado guardado. Un resultado vacío no genera cargo por resultado porque el cargo base configurado es cero.