tiktok/
live-room-info

Obtenga una sala en vivo pública de TikTok a partir del par de ID de sala y de propietario, con título, estado, identidad del propietario, imagen de portada, conteo de espectadores, conteo de Me gusta y hora de recopilación.

TikTok Live Room Info API

Sala en vivo conocida
Instantánea de audiencia
Contexto del propietario
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 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ámetrosObligatorioDescripción
room_idObligatorioIdentificador 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_idObligatorioIdentificador 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.

  1. 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.
  2. Envíe por POST ambos identificadores, como cadenas no vacías, a /v1/tiktok/live-room-info.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. 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.

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.

Explorar otras plataformas

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

TikTok Live Room Info API — FAQ

TikTok Live Room Info API es una interfaz que obtiene una sala en vivo pública conocida a partir de su room_id y del user_id del propietario. Devuelve, como instantánea en un momento dado, el título y el estado de la sala, la identidad del propietario, la imagen de portada, los conteos de espectadores y de Me gusta, y la hora de recopilación.

Use una fuente de sesiones en vivo que exponga room_id y manténgalo emparejado con el user_id numérico del propietario de la sala. Un resultado de TikTok Profiles puede aportar user_id en su campo normalizado id, pero el catálogo actual de TikTok en SocQ no descubre room_id.

Puede que la sala haya terminado, ya no esté disponible o ya no coincida con el propietario enviado, o que alguno de los identificadores no sea válido. SocQ guarda un resultado solo cuando el origen resuelve un room_id no vacío.

No. Realiza una sola consulta de una sala que usted ya conoce, y no busca salas en tendencia, no espera a que una cuenta salga en vivo, no graba video, no recopila eventos en vivo ni crea un monitor continuo.

Son valores de un momento dado, expuestos cuando se recopila la solicitud, y pueden cambiar de inmediato. Guarde collected_at junto con los conteos en lugar de tratarlos como un flujo continuo.

Cada registro de sala normalizado guardado cuesta 0.5 créditos, sin cargo base por tarea. La estimación supone un resultado, y un resultado vacío no tiene cargo.