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.
| Funcionalidad | SocQ | Twitch API |
|---|---|---|
| Uso principal | Resolver un perfil público, recopilar una página de videos de un usuario u obtener un clip | Crear integraciones nativas de Twitch en torno a los recursos de Twitch |
| Autenticación | Clave de API de SocQ | Aplicación de Twitch y la autorización de usuario o de app correspondiente |
| Entrada inicial | Un nombre de usuario, o una URL de clip para los clips | Parámetros de solicitud nativos e identificadores de recursos de Twitch |
| Administración de canales | No compatible | Use las API de Twitch autorizadas y los permisos requeridos |
| Formato de respuesta | Registros AccountItem o ReelVideoItem normalizados de SocQ | Objetos 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. 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. Seguir la tarea
Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o con error.
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.
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.itemsCasos 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.
Combine datos de varias plataformas para obtener información de negocio más completa
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.
Rednote API
Obtenga perfiles y notas públicos, busque notas o usuarios, recopile comentarios y respuestas anidadas, y capture una página de recomendaciones de inicio.
Kwai API
Obtenga perfiles públicos de Kwai, una página de publicaciones de una cuenta o una publicación conocida, con identidad, contenido, contenido multimedia, marcas de tiempo e interacción visible normalizados.
Truth Social API
Obtenga los datos de una cuenta pública, recopile una página de origen de publicaciones de una cuenta o convierta la URL de una publicación conocida en registros normalizados.
Google Ad Library API
Descubra anunciantes públicos, obtenga las creatividades de una empresa o consulte por URL una creatividad conocida del Transparency Center para investigación y revisión.
Google Maps API
Descubra lugares públicos, consulte detalles normalizados de URL conocidas de Maps y obtenga reseñas públicas con contexto del lugar y del autor vinculado a la fuente.
Amazon API
Busque productos públicos de Amazon y obtenga registros normalizados de detalles de productos, Best Sellers, reseñas, perfiles de vendedores y tiendas de creadores de los marketplaces compatibles.


