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ámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Lista 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.
- 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.
- 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.
- 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.
- 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.
- 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.
APIs relacionadas
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.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API