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ètres | Obligatoire | Description |
|---|---|---|
room_id | Obligatoire | Identifiant 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_id | Obligatoire | Identifiant 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.
- 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.
- Envoyez les deux identifiants, sous forme de chaînes non vides, en POST à /v1/tiktok/live-room-info.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut soit succeeded ou failed.
- 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é.
API associées
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.
- 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