Twitch Profile
Un perfil público de Twitch puede exponer un nombre de usuario, un nombre visible, una biografía, imágenes de perfil, un sitio web, señales de verificación o privacidad, contexto de ubicación y los conteos visibles de la cuenta. El registro de cuenta normalizado sirve para enriquecer datos de creadores, verificar perfiles y tomar instantáneas repetibles de datos públicos, sin ofrecer administración de canales ni acciones de cuenta autenticadas.
Funcionalidades de la Twitch Profile API
- Búsqueda exacta por nombre de usuarioEnvíe un nombre de usuario obligatorio de 1 a 64 caracteres admitidos, con una sola @ inicial opcional.
- Identidad pública normalizadaLea el ID del perfil, la URL pública, el nombre de usuario, el nombre visible, la biografía, el avatar, la imagen de portada y el sitio web disponibles en el contrato AccountItem.
- Señales del estado de la cuentaMantiene los indicadores disponibles de verificada y privada como campos anulables, en lugar de inferir valores cuando el proveedor no los expone.
- Métricas visibles del perfilUse los conteos disponibles de seguidores, seguidos y publicaciones como métricas opcionales independientes, ligadas a la hora de recopilación.
- Flujo de tareas asíncronoEnvíe el nombre de usuario, conserve el task_id, consulte el lector de tareas compartido y obtenga el resultado normalizado almacenado tras el éxito.
- Facturación fija por solicitudUna tarea exitosa tiene un costo fijo de 0.19 créditos de SocQ, independiente de la disponibilidad de los campos opcionales.
Parámetros de la Twitch Profile API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio | Nombre de usuario de Twitch obligatorio. Tras eliminar los espacios sobrantes, puede comenzar con una @ y luego debe contener de 1 a 64 letras ASCII, números, puntos, guiones bajos o guiones. |
Cómo usar la Twitch Profile API
Envíe un nombre de usuario de Twitch admitido, siga la tarea asíncrona y lea el único resultado de perfil almacenado mediante la respuesta compartida con cursor.
- Elija un nombre de usuario público de Twitch que cumpla la regla de caracteres admitidos.
- Envíe username por POST a /v1/twitch/profile y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
- Lea data.results.items; la consulta de perfil produce como máximo un registro de origen, aunque el envoltorio del resultado almacenado sigue incluyendo has_more y next_cursor.
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 de la Twitch Profile API
- Enriquecimiento de registros de creadores: Agregue la identidad de Twitch, la biografía, las imágenes, el sitio web, los indicadores de cuenta y los conteos públicos disponibles al registro de un creador conocido.
- Flujos de verificación de nombres de usuario: Resuelva un identificador enviado en un perfil público normalizado antes de vincularlo a una entidad interna o a un sujeto de investigación.
- Comparaciones de cuentas públicas: Compare los conteos visibles de seguidores, seguidos y publicaciones entre nombres de usuario enviados por separado, usando la misma estructura AccountItem.
- Monitoreo de cambios en el perfil: Almacene los campos de identidad anulables y las métricas con collected_at para que las ejecuciones posteriores se distingan como instantáneas públicas independientes.
Consejos de expertos para la Twitch Profile API
- Envíe un nombre de usuario y no la URL de un canal de Twitch; url y results_limit no son campos de solicitud aceptados por este endpoint.
- Use una sola @ inicial opcional; los espacios, las barras, los caracteres no ASCII y las @ repetidas incumplen la regla de nombre de usuario del runtime.
- Espere cero o un registro de perfil de origen. No interprete el parámetro limit del lector de tareas como una forma de convertir un perfil en videos o seguidores.
- Trate el ID, la URL, la biografía, las imágenes, el sitio web, los indicadores de cuenta, la ubicación y cada métrica como anulables, y conserve collected_at para comparar instantáneas.
- Use endpoints de contenido de Twitch independientes, cuando estén disponibles, para videos o clips; este endpoint es una consulta de perfil de solo lectura y no inicia sesión, publica, modera ni administra un canal.
APIs relacionadas
Además de la Twitch Profile API, use estas APIs cuando necesite otro tipo de datos públicos de Twitch.
- Twitch User Videos API
- 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.