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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL 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_limit | Opcional | Cantidad 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.
- Prepare una o más URL públicas de canales de YouTube con una ruta compatible: handle, ID de canal, nombre personalizado o usuario.
- Envíe urls y results_limit por POST a /v1/youtube/channel-live-videos y conserve el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
- 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.
APIs relacionadas
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.
- 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