tiktok/
user-live

Vérifiez par nom d’utilisateur si des comptes TikTok publics sont en live et obtenez le statut en direct ou hors ligne ainsi que les détails de salle disponibles, pour plusieurs comptes en une seule requête.

TikTok User Live API

Vérification par nom d’utilisateur
Résultats en direct et hors ligne
Plusieurs comptes par requête
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 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ètresObligatoireDescription
usernamesObligatoireListe 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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.

Explorer d’autres plateformes

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

TikTok User Live API — FAQ

TikTok User Live API est une interface programmatique qui vérifie, à partir d’une liste de noms d’utilisateur, si des comptes TikTok publics sont en live. Elle renvoie un statut en direct ou hors ligne pour chaque recherche réussie, avec les informations du créateur et les détails de salle disponibles pour les lives en cours.

Cela signifie que le compte ne diffusait pas au moment de la vérification, et non que la recherche a échoué. Un enregistrement hors ligne réussi a is_live=false et status=offline, tandis que le titre de la salle, le nombre de spectateurs ou d’autres champs de salle peuvent être vides.

Non. Saisissez le nom d’utilisateur du compte, par exemple thejustalex ou @thejustalex ; room_id et user_id relèvent de l’entrée distincte de TikTok Live Room Info.

Non. Une tâche contrôle le statut au moment où elle s’exécute, puis se termine. Pour actualiser un tableau de statut, votre propre application doit lancer une nouvelle vérification et conserver la nouvelle heure de collecte.

Non. Zéro est une valeur numérique, alors que null indique une mesure manquante. Distinguez ces deux cas, et attendez-vous à des mesures de salle vides pour les enregistrements hors ligne.

Chaque statut renvoyé coûte 0,5 crédit, y compris les résultats hors ligne réussis, sans frais de base. Par exemple, trois noms d’utilisateur distincts donnent une estimation de 1,5 crédit, et trois statuts renvoyés coûtent 1,5 crédit même si deux comptes sont hors ligne.