tiktok/
user-live

Compruebe si las cuentas públicas de TikTok están en vivo a partir de su nombre de usuario, con el estado en vivo o fuera de línea y los detalles disponibles de la sala de varias cuentas en una sola solicitud.

TikTok User Live API

Compruebe cuentas por nombre de usuario
Resultados en vivo y fuera de línea
Varias cuentas por solicitud
0.5 créditos por resultado
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

TikTok User Live

El estado en vivo de una cuenta de TikTok indica si está transmitiendo en un momento determinado, y una transmisión activa puede tener título de sala, portada y conteo de espectadores. Mantener junto con ese estado la identidad del creador de contenido y la hora permite saber qué cuenta estaba transmitiendo y qué tan reciente es la información.

Funcionalidades de la TikTok User Live API

  • Sepa si una consulta encontró una cuenta en vivo o fuera de líneaCada consulta exitosa devuelve is_live como true si la cuenta está en vivo o false si está fuera de línea, de modo que una cuenta que no transmite sigue teniendo un registro de estado en lugar de desaparecer sin más de los resultados.
  • Vea los detalles de la sala de una transmisión activaUn registro en vivo puede incluir el título de la sala, el nombre del creador de contenido, la imagen de portada y el conteo de espectadores, para que obtenga información sobre la transmisión y no solo un estado de sí o no.
  • Comience con nombres de usuario y no con identificadores de salaConsulte varios nombres de usuario públicos en una sola solicitud sin tener que encontrar antes room_id y user_id, que necesita la consulta independiente de detalle de sala en vivo.

Parámetros de la TikTok User Live API

ParámetrosObligatorioDescripción
usernamesObligatorioLista obligatoria de al menos un nombre de usuario de cuenta pública, con o sin @; en el Playground, escriba un nombre de usuario por línea, y en JSON use una lista como ["thejustalex", "@tiktok"] y no URL de perfil.

Cómo usar la TikTok User Live API

La solicitud inicia una tarea de recopilación en segundo plano, por lo que su primera respuesta entrega un ID de tarea y no los datos finales; use ese ID para comprobar el avance y obtener los resultados.

  1. Prepare uno o más nombres de usuario públicos y no enlaces de perfil ni de sala en vivo; puede copiar el nombre que aparece después de @ en el perfil de una cuenta.
  2. Antes de ejecutar el ejemplo, reemplace $SOCQ_API_KEY por su propia clave de API o defina esa variable de entorno. Envíe la entrada JSON por POST a /v1/tiktok/user-live con el encabezado Authorization que se muestra abajo y guarde el task_id de la respuesta.
  3. Use GET /v1/tasks/{task_id} con el ID guardado para comprobar el avance. queued significa en espera, running significa que la recopilación está en curso y retrying significa que se está haciendo otro intento. Espere a succeeded antes de leer los resultados; si la tarea está en failed, lea error_message para conocer el motivo.
  4. Cuando la tarea tenga éxito, lea data.results.items: cada elemento de esta lista describe el estado de una cuenta comprobada correctamente. Una lista vacía significa que la tarea terminó sin devolver ningún registro.
  5. Si data.results.has_more es true, el valor de next_cursor es el marcador de otra página de resultados guardados. Cópielo sin cambios en el parámetro cursor de GET /v1/tasks/{task_id}?cursor=... y continúe hasta que has_more sea false.
curl -X POST "https://api.socq.ai/v1/tiktok/user-live" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["thejustalex"]}'

Casos de uso de la TikTok User Live API

  • Preparar un panel del estado en vivo de las cuentas: Arme una tabla con cada creador de contenido, su estado en vivo o fuera de línea y la hora de recopilación, para que alguien pueda comprobar cuáles de las cuentas enviadas estaban transmitiendo en la observación más reciente.
  • Crear una lista de revisión de transmisiones activas: Seleccione los registros con is_live=true y combine sus enlaces de sala, títulos y conteos de espectadores en una lista de salas activas que abrir y revisar.

Consejos de expertos para la TikTok User Live API

  • Antes de enviar una lista repetida de nombres de usuario, quite las @ iniciales y deduplique sin distinguir mayúsculas y minúsculas, para que tiktok y @TikTok no inflen la estimación del número de entradas.
  • Cuando un registro indique is_live=false, muéstrelo como fuera de línea y deje vacíos los campos ausentes de la sala, en lugar de informar que la consulta de la cuenta falló.
  • En un panel de estado que usted mismo actualiza, muestre collected_at junto al estado para que un resultado anterior no se confunda con una observación hecha en este momento.
  • Si ya tiene un room_id y un user_id que coinciden y quiere una consulta de sala independiente, use TikTok Live Room Info en lugar de enviar esos ID en el campo usernames.

Además de la TikTok User Live API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.

  • TikTok Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, indicadores de cuenta y conteos de audiencia.
  • TikTok Videos API — Obtiene el creador, la descripción, el contenido multimedia, la música, las etiquetas, las menciones y la interacción desde URLs de videos.
  • TikTok User Videos API — Recolecta videos públicos del feed de un perfil por nombre de usuario, con descripciones, creadores, contenido multimedia, marcas de tiempo, interacción y contexto de la cuenta de origen.
  • TikTok Live Room Info API — Consulta una transmisión en vivo conocida mediante el par de IDs de la sala y del propietario, y devuelve su estado, el contexto del propietario, la portada y los conteos de audiencia.
  • TikTok Trending Feed API — Recolecta el feed actual de videos públicos de una región, con campos de creador, descripción, portada, marca de tiempo e interacción visible.
  • TikTok Live Shopping API — Enumera los productos de la bolsa de compras de una transmisión en vivo, con precios actuales y unidades vendidas.

Explorar otras plataformas

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

TikTok User Live API — FAQ

TikTok User Live API es una interfaz que comprueba si las cuentas públicas de TikTok están en vivo a partir de una lista de nombres de usuario. Devuelve un estado en vivo o fuera de línea por cada consulta exitosa, además de la información del creador de contenido y los detalles disponibles de la sala en las transmisiones activas.

Significa que la cuenta no estaba transmitiendo cuando se comprobó, no que la consulta haya fallado. Un registro exitoso fuera de línea tiene is_live=false y status=offline, mientras que el título de la sala, el conteo de espectadores u otros campos de la sala pueden estar vacíos.

No. Ingrese el nombre de usuario de la cuenta, como thejustalex o @thejustalex; room_id y user_id corresponden a la entrada independiente de TikTok Live Room Info.

No. Una tarea comprueba el estado cuando se ejecuta y luego termina. Si necesita un panel de estado actualizado, su propia aplicación debe ejecutar otra comprobación y conservar la nueva hora de recopilación.

No. Cero es un valor numérico, mientras que null significa que falta la medición. Mantenga esos casos separados y espere que las mediciones de la sala estén vacías en los registros fuera de línea.

Cada estado devuelto cuesta 0.5 créditos, incluidos los resultados fuera de línea exitosos, sin cargo base. Por ejemplo, tres nombres de usuario distintos estiman 1.5 créditos, y tres estados devueltos cuestan 1.5 créditos aunque dos cuentas estén fuera de línea.