tiktok/
live-room-info

Récupérez un live TikTok public à partir de son ID de salle et de l’ID de son propriétaire, avec titre, statut, identité du propriétaire, image de couverture, nombre de spectateurs, nombre de mentions J’aime et heure de collecte.

TikTok Live Room Info API

Live connu
Instantané d’audience
Contexte du propriétaire
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

TikTok Live Room Info

TikTok Live Room Info donne une vue à un instant donné d’un live public en cours, avec son titre, son statut, l’identité du propriétaire, l’image de couverture et les nombres visibles de spectateurs et de mentions J’aime. Ces champs servent à vérifier l’état d’un live, à prendre des instantanés d’audience, à enrichir des fiches de live et à produire des rapports horodatés pour des lives déjà connus.

Fonctionnalités de la TikTok Live Room Info API

  • Recherche par ID de salle et de propriétaireRésolvez un live connu à partir de son room_id et du user_id de son propriétaire, pour obtenir au plus un enregistrement live_room normalisé.
  • Contexte du live et du propriétaireRenvoie le titre et le statut actuels du live avec l’ID public, le nom d’utilisateur et le nom affiché du propriétaire.
  • Instantané d’audience et de couvertureCapture le nombre de spectateurs visible, le nombre de mentions J’aime, l’image de couverture publique et l’horodatage de collecte pour une lecture à un instant donné.

Paramètres de la TikTok Live Room Info API

ParamètresObligatoireDescription
room_idObligatoireIdentifiant de live obligatoire et non vide. Fournissez l’identifiant numérique sous forme de chaîne, issu d’une source qui expose la session live TikTok en cours.
user_idObligatoireIdentifiant numérique TikTok obligatoire et non vide du propriétaire du live, fourni sous forme de chaîne et associé au même live.

Comment utiliser la TikTok Live Room Info API

Associez les identifiants d’un live actif connu, envoyez une recherche asynchrone, puis lisez l’instantané normalisé dans les résultats de la tâche.

  1. Obtenez room_id auprès d’une source qui expose la session live TikTok en cours, et récupérez le user_id correspondant du propriétaire dans le même contexte ou dans un résultat de TikTok Profiles.
  2. Envoyez les deux identifiants, sous forme de chaînes non vides, en POST à /v1/tiktok/live-room-info.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut soit succeeded ou failed.
  4. Lisez data.results.items depuis /v1/tasks/{task_id}?limit=50 ; un live résolu produit au plus un enregistrement, et le next_cursor standard ne s’applique que si results.has_more vaut 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.

Cas d’usage de la TikTok Live Room Info API

  • Vérifications ponctuelles de l’état d’un live : Servez-vous du statut, du titre, de l’ID du live et de la valeur collected_at renvoyés pour confirmer l’instantané disponible pour un live connu.
  • Rapports d’instantanés d’audience : Enregistrez viewers_count et likes_count avec collected_at pour comparer des observations faites à différents moments d’une diffusion connue.
  • Enrichissement de lives : Rattachez l’ID du propriétaire, son nom d’utilisateur, son nom affiché, le titre du live, son statut et l’image de couverture à un enregistrement de live existant.

Conseils d’expert pour la TikTok Live Room Info API

  • Gardez room_id associé au user_id du propriétaire issu de la même session active ; un live et un utilisateur qui ne correspondent pas peuvent ne renvoyer aucun enregistrement, ou une erreur de la source propre à l’entrée.
  • Conservez les deux identifiants sous forme de chaînes pour que les grands ID numériques TikTok ne soient pas arrondis par un client ou une base de données.
  • Lancez la recherche pendant que le live est censé être en cours, et voyez dans un résultat vide un live terminé, indisponible, invalide ou non concordant, et non un enregistrement de live hors ligne découvert.
  • Utilisez collected_at comme heure d’observation du statut et des métriques ; created_at vaut null et url est vide dans l’enregistrement normalisé.

En complément de la TikTok Live Room Info API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok.

  • TikTok Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, indicateurs de compte et nombres d’audience.
  • TikTok Hashtags API — Collectez les vidéos publiques, créateurs, médias, sons et l’engagement pour des hashtags donnés.
  • TikTok Search API — Recherchez des vidéos publiques par mot-clé avec tris et filtres de publication pris en charge.
  • TikTok User Videos API — Collectez par nom d’utilisateur les vidéos publiques du fil d’un profil avec légendes, créateurs, médias, horodatages, engagement et contexte du compte source.
  • TikTok Search Users API — Recherchez des comptes TikTok publics par mot-clé.
  • TikTok Top Search API — Recherchez par mot-clé des vidéos et des publications d’images, avec légendes, créateurs et nombres d’interactions.

Explorer d’autres plateformes

Combinez les données TikTok avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Live Room Info API — FAQ

TikTok Live Room Info API est une interface qui récupère un live public connu à partir de son room_id et du user_id de son propriétaire. Elle renvoie le titre et le statut du live, l’identité du propriétaire, l’image de couverture, les nombres de spectateurs et de mentions J’aime ainsi que l’heure de collecte, sous forme d’instantané.

Utilisez une source de session live qui expose room_id et gardez-le associé au user_id numérique du propriétaire. Un résultat de TikTok Profiles peut fournir user_id dans son champ normalisé id, mais le catalogue TikTok actuel de SocQ ne permet pas de découvrir room_id.

Le live a pu se terminer, devenir indisponible ou ne plus correspondre au propriétaire envoyé, ou bien l’un des identifiants est invalide. SocQ n’enregistre un résultat que si la source résout un room_id non vide.

Non. Il effectue une seule recherche pour un live que vous connaissez déjà : il ne cherche pas les lives tendance, n’attend pas qu’un compte passe en direct, n’enregistre pas la vidéo, ne collecte pas les événements du live et ne crée aucune surveillance continue.

Ce sont des valeurs ponctuelles, exposées au moment de la collecte, qui peuvent changer aussitôt. Stockez collected_at avec les nombres au lieu de les traiter comme un flux continu.

Chaque enregistrement de live normalisé sauvegardé coûte 0,5 crédit, sans frais de base par tâche. L’estimation suppose un résultat, et un résultat vide n’entraîne aucun frais de résultat.