Volver a las API
Datos públicos de Twitch

Twitch Public Data API

Convierta un nombre de usuario público conocido de Twitch en un perfil normalizado, recopile su inventario público de videos u obtenga un clip con su video descargable para investigación de creadores de contenido, enriquecimiento de catálogos, comparaciones y monitoreo mediante instantáneas.

API de Twitch disponibles

Use Twitch Profile API para obtener la identidad normalizada de una cuenta, Twitch User Videos API para una página de videos públicos con filtros compatibles de tipo y orden, o Twitch Clip Downloader API para un clip público a partir de su URL.

¿Qué datos de Twitch se pueden obtener?

El catálogo de Twitch devuelve un registro público normalizado de una cuenta o una página de videos públicos normalizados a partir de un nombre de usuario, o un clip público a partir de su URL, con campos que admiten null cuando la fuente no expone un valor.

Identidad del perfil

Obtenga el ID de la cuenta, la URL pública, el nombre de usuario, el nombre visible y la biografía que estén disponibles.

Presentación del perfil

Conserve los campos disponibles de avatar, imagen de portada y sitio web asociado.

Señales de la cuenta

Lea los indicadores de cuenta verificada y privada, que admiten null, sin deducir los valores ausentes.

Conteos visibles de la cuenta

Conserve los conteos disponibles de seguidores, seguidos y publicaciones junto con collected_at para comparaciones de un momento determinado.

Videos públicos de usuarios

Recopile la identidad del video, el contexto del creador, la multimedia, la duración, la fecha de publicación y la interacción visible de una página de origen.

Clips públicos

Obtenga el título, las vistas, la duración, la fecha de creación y el streamer de un clip, además de un enlace MP4 descargable con su miniatura.

SocQ vs Twitch API

SocQ ofrece la obtención de perfiles públicos, videos de usuarios y clips en flujos de tareas normalizados; las API nativas de Twitch y su autenticación son adecuadas para integraciones de aplicaciones autorizadas y operaciones de canales.

FuncionalidadSocQTwitch API
Uso principalResolver un perfil público, recopilar una página de videos de un usuario u obtener un clipCrear integraciones nativas de Twitch en torno a los recursos de Twitch
AutenticaciónClave de API de SocQAplicación de Twitch y la autorización de usuario o de app correspondiente
Entrada inicialUn nombre de usuario, o una URL de clip para los clipsParámetros de solicitud nativos e identificadores de recursos de Twitch
Administración de canalesNo compatibleUse las API de Twitch autorizadas y los permisos requeridos
Formato de respuestaRegistros AccountItem o ReelVideoItem normalizados de SocQObjetos de respuesta nativos de Twitch

Cómo funciona la API de Twitch

Todas las API de Twitch usan el flujo compartido de SocQ de tareas asíncronas y resultados almacenados.

  1. 1. Elegir un endpoint

    Envíe por POST un nombre de usuario público válido a /v1/twitch/profile o /v1/twitch/user-videos, o una URL de clip a /v1/twitch/clip, y guarde el task_id.

  2. 2. Seguir la tarea

    Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o con error.

  3. 3. Leer los registros almacenados

    Use data.results.items para los registros de perfiles o videos y conserve el contexto del momento de recopilación.

Resolver un perfil público de Twitch

Autentíquese con una clave de API de SocQ y envíe exactamente un nombre de usuario compatible. La tarea exitosa tiene un costo fijo de 0.19 créditos.

curl -X POST "https://api.socq.ai/v1/twitch/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja"}'

# Poll GET /v1/tasks/{task_id}
# Read the normalized account in data.results.items

Casos de uso frecuentes de la API de Twitch

Enriquecimiento de la identidad de creadores

Agregue a registros de creadores conocidos la identidad, la biografía, las imágenes, el sitio web, los indicadores de la cuenta y los conteos públicos de Twitch que estén disponibles.

Resolución de nombres de usuario

Resuelva un nombre de usuario enviado antes de asociar el perfil público con una entidad de investigación interna.

Comparación de cuentas

Compare perfiles recopilados por separado mediante los mismos campos de identidad y métricas que admiten null.

Monitoreo mediante instantáneas

Conserve collected_at junto con los valores públicos del perfil para que las ejecuciones posteriores sigan siendo instantáneas distinguibles.

Enriquecimiento del inventario de videos

Agregue a canales conocidos la identidad del video público, la multimedia, el contexto del creador, la duración, las marcas de tiempo y la interacción visible.

Archivo de momentos destacados

Guarde el MP4 de un clip con su título, su streamer y su fecha de creación para armar una biblioteca consultable con los mejores momentos de un canal.

Límites y política de datos públicos

Los endpoints de Twitch son consultas de solo lectura de perfiles públicos, videos de usuarios y clips. No ofrecen acciones autenticadas de canales ni datos de miembros de la audiencia.

  • Profile y User Videos aceptan un solo nombre de usuario; no aceptan la URL de un canal, una lista de nombres de usuario ni results_limit.
  • Twitch Clip Downloader acepta una URL de clip con el formato twitch.tv/<channel>/clip/<slug> o clips.twitch.tv/<slug>; el enlace MP4 devuelto está firmado y caduca en torno a un día.
  • El nombre de usuario puede comenzar con un @ y, por lo demás, debe contener de 1 a 64 letras ASCII, números, puntos, guiones bajos o guiones.
  • La consulta de perfil devuelve como máximo un objeto de perfil de origen; User Videos recopila una página de origen y no acepta un cursor ni un results_limit controlados por quien llama.
  • La identidad del perfil, las imágenes, el sitio web, los indicadores, la ubicación y las métricas individuales pueden ser null cuando los datos públicos de origen no están disponibles.
  • El endpoint no inicia sesión, ni publica, modera, administra un canal, obtiene analítica privada ni realiza acciones de cuenta autorizadas con OAuth.

Preguntas frecuentes sobre la API de Twitch

¿Qué es la API de Twitch?

Las API de Twitch usan tareas asíncronas para convertir un nombre de usuario público conocido en un perfil normalizado, para recopilar una página de sus videos públicos o para obtener un clip público a partir de su URL.

¿Qué API de Twitch están disponibles actualmente?

Actualmente están disponibles Twitch Profile API, Twitch User Videos API y Twitch Clip Downloader API.

¿Puedo enviar una URL de Twitch?

Twitch Clip Downloader API recibe una URL de clip en url. Twitch Profile y User Videos requieren username y rechazan url, urls y otros campos no declarados.

¿Esta API administra un canal de Twitch?

No. Todos los endpoints de Twitch son consultas públicas de solo lectura y no autentican a un usuario de Twitch, ni publican, moderan, administran la configuración del canal ni obtienen analítica privada.

¿Por qué los campos pueden ser null?

Los registros normalizados de cuentas y videos conservan los campos públicos opcionales como null cuando la fuente o el proveedor no expone un valor en el momento de la recopilación.

¿Cuánto cuestan las solicitudes de Twitch?

Cada tarea exitosa de Twitch Profile o User Videos cuesta 0.19 créditos de SocQ fijos. Cada solicitud de Twitch Clip Downloader cuesta 0.5 créditos, y un clip que no se encuentra se reembolsa por completo.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.