twitch/
profile

Convierta un nombre de usuario público de Twitch en un registro de perfil normalizado con identidad, biografía, imágenes, indicadores de cuenta, métricas visibles y contexto de recopilación.

Twitch Profile API

Un solo nombre de usuario
Registro de cuenta normalizado
Costo fijo por solicitud
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 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ámetrosObligatorioDescripción
usernameObligatorioNombre 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.

  1. Elija un nombre de usuario público de Twitch que cumpla la regla de caracteres admitidos.
  2. Envíe username por POST a /v1/twitch/profile y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
  4. 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.items

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

Además de la Twitch Profile API, use estas APIs cuando necesite otro tipo de datos públicos de Twitch.

Explorar otras plataformas

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

Twitch Profile API — FAQ

Twitch Profile API es una interfaz que obtiene un registro de cuenta normalizado a partir de un nombre de usuario público de Twitch, con la identidad, la biografía, las imágenes, los indicadores de cuenta, la ubicación, las métricas y la hora de recopilación disponibles.

Tras eliminar los espacios sobrantes, username acepta una @ inicial opcional seguida de 1 a 64 letras ASCII, números, puntos, guiones bajos o guiones. Se rechazan los espacios, las barras, las @ adicionales y otros caracteres.

No. El contrato de la solicitud acepta un username obligatorio y rechaza campos enviados por quien llama, como usernames, url, urls y results_limit.

La ruta del proveedor resuelve como máximo un objeto de perfil para el nombre de usuario enviado. Los resultados completados siguen usando el envoltorio compartido de resultados almacenados con los campos limit, has_more y next_cursor.

El contrato normalizado permite valores null para el ID, la URL, el nombre de usuario, el nombre, la biografía, las imágenes, el sitio web, la verificación, la privacidad, la ubicación y cada métrica cuando los datos públicos del origen no están disponibles.

Cada tarea exitosa cuesta una tarifa fija de 0.19 créditos de SocQ. El monto fijo no varía con la cantidad de campos opcionales con datos en el único resultado de perfil.