TikTok Live Room Info
TikTok Live Room Info representa una vista en un momento dado de una sala pública activa, con su título, estado, identidad del propietario, imagen de portada y los conteos visibles de espectadores y de Me gusta. Estos campos sirven para verificar el estado en vivo, tomar instantáneas de audiencia, enriquecer salas y generar informes con marca de tiempo de salas que ya se conocen.
Funcionalidades de la TikTok Live Room Info API
- Búsqueda por par de sala y propietarioResuelve una sala en vivo conocida a partir de su room_id y del user_id del propietario correspondiente, y devuelve como máximo un registro live_room normalizado.
- Contexto de la sala y del propietarioDevuelve el título y el estado actuales de la sala junto con el ID público, el nombre de usuario y el nombre visible del propietario.
- Instantánea de audiencia y portadaCaptura el conteo visible de espectadores, el conteo de Me gusta, la imagen de portada pública y la marca de tiempo de recopilación, para interpretarlos en un momento dado.
Parámetros de la TikTok Live Room Info API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
room_id | Obligatorio | Identificador obligatorio y no vacío de la sala en vivo. Proporcione el identificador numérico como cadena, tomado de una fuente que exponga la sesión en vivo actual de TikTok. |
user_id | Obligatorio | Identificador numérico obligatorio y no vacío de TikTok del propietario de la sala, proporcionado como cadena y emparejado con la misma sala. |
Cómo usar la TikTok Live Room Info API
Empareje los identificadores de una sala activa conocida, envíe una consulta asíncrona y lea la instantánea normalizada en los resultados de la tarea.
- Obtenga room_id de una fuente que exponga la sesión en vivo actual de TikTok, y obtenga el user_id del propietario correspondiente del mismo contexto o de un resultado de TikTok Profiles.
- Envíe por POST ambos identificadores, como cadenas no vacías, a /v1/tiktok/live-room-info.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea data.results.items desde /v1/tasks/{task_id}?limit=50; una sala resuelta produce como máximo un registro, y el next_cursor estándar solo aplica si results.has_more es true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-room-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id":"7523685855395842871","user_id":"6742945285876515845"}'
# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.Casos de uso de la TikTok Live Room Info API
- Verificaciones puntuales del estado en vivo: Use el estado, el título, el ID de la sala y el valor de collected_at devueltos para confirmar la instantánea disponible de una sala conocida.
- Informes de instantáneas de audiencia: Registre viewers_count y likes_count junto con collected_at para comparar observaciones hechas en momentos distintos durante una transmisión conocida.
- Enriquecimiento de salas en vivo: Agregue el ID del propietario, el nombre de usuario, el nombre visible, el título de la sala, el estado y la imagen de portada a un registro existente de sala en vivo.
Consejos de expertos para la TikTok Live Room Info API
- Mantenga room_id emparejado con el user_id del propietario de la misma sesión activa; una discrepancia entre sala y usuario puede no devolver ningún registro o producir un error del origen específico de la entrada.
- Conserve ambos identificadores como cadenas para que ningún cliente ni base de datos redondee los ID numéricos grandes de TikTok.
- Ejecute la consulta mientras se espera que la sala esté en vivo, y trate un resultado vacío como sala finalizada, no disponible, no válida o no coincidente, y no como el registro de una sala fuera de línea descubierta.
- Use collected_at como hora de observación del estado y de las métricas; created_at es null y url está vacío en el registro normalizado.
APIs relacionadas
Además de la TikTok Live Room Info 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 Hashtags API — Recolecta videos públicos, creadores, contenido multimedia, sonido e interacción de los hashtags indicados.
- TikTok Search API — Busca videos públicos por palabra clave con filtros de orden y de publicación compatibles.
- 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 Search Users API — Busca cuentas públicas de TikTok por palabra clave.
- TikTok Top Search API — Busca por palabra clave videos y publicaciones de imágenes, con descripciones, creadores y conteos de interacción.
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok User Live 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 Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API