twitch/
user-videos

Recopile una página de videos públicos de Twitch de un nombre de usuario, con filtros opcionales de tipo y orden, con contexto del creador, contenido multimedia, duración e interacción visible.

Twitch User Videos API

Videos del canal
Filtros por tipo
Interacción visible
0.19 créditos por solicitud
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

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ámetrosObligatorioDescripción
usernameObligatorioUn 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_byOpcionalTipo 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_byOpcionalOrden 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.

  1. 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.
  2. Envíe username, filter_by y sort_by por POST a /v1/twitch/user-videos y guarde el ID de la tarea devuelto.
  3. 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.
  4. 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=50

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

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.

Explorar otras plataformas

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

Twitch User Videos API — FAQ

Twitch User Videos API es una interfaz programática para recopilar una página de registros de videos públicos de un nombre de usuario de Twitch. Devuelve la identidad del video, 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, todo normalizado.

username es obligatorio y acepta una @ opcional seguida de 1 a 64 letras, números, puntos, guiones bajos o guiones. filter_by acepta all, archive, archives, highlight, highlights, upload o uploads; sort_by acepta time o views.

Cada ReelVideoItem puede incluir un ID, la URL pública, la descripción, los datos del creador, el contenido multimedia, los hashtags, las menciones, la duración, los metadatos de audio, la hora de publicación, la hora de recopilación y los Me gusta, comentarios, veces compartido, reproducciones o vistas visibles. La disponibilidad en el origen determina qué campos anulables contienen valores.

No. El contrato de envío realiza una sola solicitud al origen y no acepta cursor ni results_limit. Una vez completada la tarea, next_cursor puede recorrer las filas de resultados ya almacenadas para esa tarea, pero no obtiene otra página de origen.

Cada tarea exitosa usa una tarifa fija de 0.19 créditos, independiente de la cantidad de registros devueltos en la página de origen.

Una tarea exitosa puede no contener elementos cuando la página de origen pública no tiene registros elegibles para el tipo y el orden seleccionados, o cuando los videos coincidentes no están disponibles. Trate un resultado vacío por separado de una tarea fallida.