Twitch User Videos
Los videos de usuarios de Twitch son archivos, momentos destacados y subidas públicas de un canal, con descripciones, contexto del creador, referencias multimedia, duración, hora de publicación e interacción visible. Estos registros sirven para catalogar canales, comparar formatos, investigar la publicación de contenido y elaborar informes de rendimiento de un momento dado.
Funcionalidades de la Twitch User Videos API
- Inventario por nombre de usuarioResuelve un nombre de usuario público de Twitch en los registros de video que se devuelven para ese canal en una sola solicitud al origen.
- Filtros de archivos, momentos destacados y subidasSeleccione todos los videos o acote la solicitud al origen con los valores aceptados de archive, highlight o upload y sus alias en plural.
- Orden por fecha o por vistasOrdene la página de origen devuelta por fecha o por vistas visibles para inspeccionar las publicaciones recientes o los videos con más vistas.
- Registros de video normalizadosDevuelve la identidad del video, la URL pública, la descripción, el contexto del creador, el contenido multimedia, la duración, la hora de publicación, los metadatos de audio y la interacción visible en la estructura ReelVideoItem.
Parámetros de la Twitch User Videos API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio | Un nombre de usuario público de Twitch, que opcionalmente puede comenzar con @, con 1 a 64 letras, números, puntos, guiones bajos o guiones. |
filter_by | Opcional | Tipo de origen opcional: all, archive, archives, highlight, highlights, upload o uploads. Los alias de tipo en singular y en plural se asignan a la misma categoría del proveedor. |
sort_by | Opcional | Orden de origen opcional: time o views. |
Cómo usar la Twitch User Videos API
Envíe un nombre de usuario de Twitch con controles opcionales de tipo de video y orden, y luego lea la página de origen mediante el flujo estándar de tareas asíncronas.
- Elija un nombre de usuario público de Twitch y decida si la página de origen debe abarcar todos los videos o un tipo de video aceptado.
- Envíe username, filter_by y sort_by por POST a /v1/twitch/user-videos y guarde el ID de la tarea devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o falle; no vuelva a enviar la solicitud cuando ya exista un ID de tarea.
- Lea los registros ReelVideoItem de results.items y use next_cursor solo para recorrer las filas almacenadas de la tarea.
curl -X POST "https://api.socq.ai/v1/twitch/user-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"ninja","filter_by":"all","sort_by":"time"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Casos de uso de la Twitch User Videos API
- Catalogación de videos de un canal: Use los ID de video, las URL públicas, las descripciones, las referencias multimedia, la duración y el contexto del creador para armar un inventario actual de un canal conocido.
- Revisión de la mezcla de formatos: Ejecute por separado los filtros de tipo aceptados y compare los registros de archivos, momentos destacados y subidas por hora de publicación y duración.
- Instantáneas de publicación y vistas: Combine las marcas de tiempo de publicación con las métricas visibles de vistas o reproducciones y con collected_at para registrar una instantánea del canal en un momento dado.
Consejos de expertos para la Twitch User Videos API
- Al proporcionar un nombre de usuario, elimine las URL de perfil y conserve solo la @ opcional y los 1 a 64 caracteres de nombre de usuario aceptados.
- Use time para inspeccionar las publicaciones recientes y views para inspeccionar los registros con más vistas dentro de la página de origen devuelta.
- Elija de forma consistente los alias de tipo en singular o en plural en las definiciones de solicitud que almacene, porque cada par se asigna a la misma categoría de origen.
- No agregue cursor ni results_limit al cuerpo del envío; la llamada al proveedor devuelve una página, mientras que el cursor del resultado de la tarea solo pagina las filas que SocQ ya almacenó.
- Deduplique las recopilaciones longitudinales por ID de video y tolere los campos anulables de texto, contenido multimedia, audio, autor, marca de tiempo y métricas.
APIs relacionadas
Además de la Twitch User Videos API, use estas APIs cuando necesite otro tipo de datos públicos de Twitch.
- Twitch Profile API — Convierte un nombre de usuario público de Twitch en un registro de cuenta normalizado con identidad, biografía, imágenes, indicadores de cuenta, métricas visibles y contexto de recolección disponibles.
- Twitch Clip Downloader API — Obtiene un clip público de Twitch a partir de su URL con título, vistas, duración, fecha de creación, perfil del streamer y un enlace MP4 descargable con miniatura.