tiktok/
live-ranking

Récupérez le classement quotidien des créateurs de TikTok LIVE en un seul appel : jusqu’à 99 hôtes avec rang, score fondé sur les cadeaux, ID utilisateur, identifiant, nom affiché, nombre d’abonnés et lien du profil.

TikTok Live Ranking API

Aucune entrée requise
Jusqu’à 99 hôtes
Score fondé sur les cadeaux
0,5 crédit par requête
Prêt
Prêt

Envoyez la requête vide. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

TikTok Live Ranking

Le classement quotidien de TikTok LIVE est le palmarès du jour des hôtes de live, ordonné par un score issu des cadeaux que les spectateurs envoient pendant leurs diffusions ; chaque entrée indique la position, le score et le nombre d’abonnés de l’hôte. Le lire montre quels hôtes les spectateurs soutiennent aujourd’hui, comment bougent les premières places et quels comptes plus modestes reçoivent davantage de soutien que leur audience ne le laisserait penser.

Fonctionnalités de la TikTok Live Ranking API

  • Tout le classement, sans paramètreLa requête n’accepte aucune entrée et renvoie le classement quotidien du moment, jusqu’à 99 hôtes, chacun avec son rang.
  • Le score à côté de la taille de l’audiencescore est la valeur de classement fondée sur les cadeaux et followers_count le total d’abonnés de l’hôte : soutien et audience se comparent sans seconde requête.
  • L’identité de l’hôte sur chaque ligneauthor fournit l’ID utilisateur, l’identifiant, le nom affiché, le lien du profil et l’avatar de l’hôte.

Paramètres de la TikTok Live Ranking API

Prêt à l’envoi

Cet endpoint n’exige aucun paramètre de requête. Envoyez l’objet JSON vide tel quel.

{}

Comment utiliser la TikTok Live Ranking API

Envoyez une requête vide et lisez les hôtes classés.

  1. Envoyez {} en POST à /v1/tiktok/live-ranking.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les hôtes dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Each item has rank, score, author and followers_count.

Cas d’usage de la TikTok Live Ranking API

  • Suivre le classement au fil de la journée : Récupérez le classement à heures fixes et tracez le rang et le score de chaque hôte pour voir qui monte et à quel moment l’ordre change.
  • Repérer des hôtes pour des agences et des sponsors : Divisez score par followers_count pour trouver les hôtes dont les spectateurs donnent beaucoup par rapport à la taille de l’audience, puis présélectionnez-les en vue d’un contrat ou d’un sponsoring.

Conseils d’expert pour la TikTok Live Ranking API

  • Planifiez les collectes à la même heure chaque jour : un score lu à midi et un autre lu à minuit ne couvrent pas la même portion de la journée.
  • Le classement n’indique pas si l’hôte est en direct. Rapprochez les hôtes sur author.id et envoyez leurs noms d’utilisateur à TikTok User Live pour savoir qui diffuse en ce moment.

En complément de la TikTok Live Ranking 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 Followers List API — Collectez les profils normalisés visibles dans les listes publiques d’abonnés, avec le contexte source conservé et les indicateurs pris en charge.
  • TikTok Following List API — Collectez les profils publics suivis par des comptes TikTok avec identité normalisée, biographies, indicateurs visibles et contexte du compte source.
  • TikTok User Live API — Vérifiez si des noms d’utilisateur sont en live ou hors ligne et obtenez les détails disponibles de la salle de live.
  • TikTok Audience Demographics API — Découvrez, par nom d’utilisateur, de quels pays viennent les abonnés d’un créateur, avec la part de l’audience de chaque pays.
  • TikTok Live Search API — Trouvez par mot-clé les LIVE en cours de diffusion, avec hôtes, titres et spectateurs actuels.

Explorer d’autres plateformes

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

TikTok Live Ranking API — FAQ

TikTok Live Ranking API est une interface programmatique pour lire le classement quotidien des créateurs de TikTok LIVE, sans aucune entrée. Elle renvoie jusqu’à 99 hôtes avec rang, score fondé sur les cadeaux, ID utilisateur, identifiant, nom affiché et nombre d’abonnés.

score est la valeur selon laquelle TikTok classe les hôtes aujourd’hui, d’après les cadeaux reçus pendant leurs lives. C’est un score de classement, et non un paiement dans une devise.

Pas avec cet endpoint. Il n’accepte aucune entrée et renvoie le classement quotidien du moment : conservez vos propres copies si vous avez besoin d’un historique.

Les positions bougent à mesure que les cadeaux arrivent dans la journée. Une collecte coûte 0,5 crédit forfaitaire pour tout le classement : un rythme horaire revient donc à 12 crédits par jour.

Non. Le classement porte sur les hôtes qui les ont reçus, avec le rang, le score et le profil de chacun, et ne contient aucune liste des donateurs.