TikTok User Live
Le statut de live d’un compte TikTok indique s’il diffuse à un instant précis, et un live en cours peut afficher un titre de salle, une couverture et un nombre de spectateurs. Associer l’identité du créateur et l’heure à ce statut permet de savoir quel compte diffusait et à quel point l’information est récente.
Fonctionnalités de la TikTok User Live API
- Savoir si le compte trouvé est en direct ou hors ligneChaque recherche réussie renvoie is_live à true pour un compte en direct ou à false pour un compte hors ligne : un compte qui ne diffuse pas garde donc un enregistrement de statut, au lieu de disparaître des résultats.
- Voir les détails de la salle d’un live en coursUn enregistrement en direct peut inclure le titre de la salle, le nom du créateur, l’image de couverture et le nombre de spectateurs, de quoi renseigner sur la diffusion et pas seulement répondre par oui ou par non.
- Partir des identifiants de compte plutôt que des identifiants de salleInterrogez plusieurs noms d’utilisateur publics en une requête, sans devoir d’abord retrouver room_id et user_id, que réclame la recherche distincte live-room-detail.
Paramètres de la TikTok User Live API
| Paramètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Liste obligatoire d’au moins un identifiant de compte public, avec ou sans @ ; dans le Playground, saisissez un nom d’utilisateur par ligne, et en JSON utilisez un tableau tel que ["thejustalex", "@tiktok"] plutôt que des URL de profil. |
Comment utiliser la TikTok User Live API
La requête lance une tâche de collecte en arrière-plan : sa première réponse vous donne donc un ID de tâche et non les données finales ; servez-vous de cet ID pour suivre l’avancement et récupérer les résultats.
- Préparez un ou plusieurs noms d’utilisateur publics, et non des liens de profil ou de salle de live ; vous pouvez copier l’identifiant situé après le @ sur le profil d’un compte.
- Avant de lancer l’exemple, remplacez $SOCQ_API_KEY par votre propre clé API ou définissez cette variable d’environnement. Envoyez l’entrée JSON en POST à /v1/tiktok/user-live avec l’en-tête Authorization indiqué ci-dessous, puis conservez le task_id de la réponse.
- Appelez GET /v1/tasks/{task_id} avec l’ID conservé pour suivre l’avancement. queued signifie en attente, running que la collecte est en cours et retrying qu’une nouvelle tentative est en cours. Attendez succeeded avant de lire les résultats ; si la tâche est en failed, lisez error_message pour en connaître la raison.
- Une fois la tâche réussie, lisez data.results.items : chaque élément de cette liste décrit le statut d’un compte vérifié avec succès. Une liste vide signifie que la tâche s’est terminée sans renvoyer d’enregistrement.
- Si data.results.has_more vaut true, la valeur next_cursor est le repère d’une autre page de résultats sauvegardés. Copiez-la telle quelle dans le paramètre cursor de GET /v1/tasks/{task_id}?cursor=... et continuez jusqu’à ce que has_more vaille 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"]}'Cas d’usage de la TikTok User Live API
- Tableau de suivi du statut de live : Construisez un tableau avec chaque créateur, son statut en direct ou hors ligne et l’heure de collecte, pour vérifier lesquels des comptes fournis diffusaient lors de la dernière observation.
- Liste de revue des lives en cours : Sélectionnez les enregistrements où is_live=true et réunissez leurs liens de salle, titres et nombres de spectateurs en une liste de salles actives à ouvrir et à examiner.
Conseils d’expert pour la TikTok User Live API
- Avant d’envoyer une liste d’identifiants répétée, retirez les @ initiaux et dédoublonnez sans tenir compte de la casse, pour que tiktok et @TikTok ne gonflent pas l’estimation du nombre d’entrées.
- Quand un enregistrement indique is_live=false, affichez-le comme hors ligne et laissez vides les champs de salle manquants, plutôt que de signaler un échec de la recherche du compte.
- Pour un tableau de statut que vous actualisez vous-même, affichez collected_at à côté du statut afin qu’un ancien résultat ne passe pas pour une observation toute fraîche.
- Si vous disposez déjà d’un room_id et d’un user_id correspondants et voulez une recherche de salle distincte, utilisez TikTok Live Room Info plutôt que d’envoyer ces ID dans le champ usernames.
API associées
En complément de la TikTok User Live 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 Videos API — Récupérez le créateur, la légende, les médias, la musique, les tags, les mentions et l’engagement à partir d’URL de vidéos.
- 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 Live Room Info API — Consultez un live connu à partir de la paire d’ID de salle et de propriétaire, et obtenez le statut, le contexte du propriétaire, le média de couverture et les nombres d’audience.
- TikTok Trending Feed API — Collectez le fil actuel de vidéos publiques d’une région avec créateur, légende, couverture, horodatage et engagement visible.
- TikTok Live Shopping API — Listez les produits du panier d’achat d’un LIVE, avec prix actuels et unités vendues.
- 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