Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

API analytics TikTok : statistiques du compte et métriques vidéo

L'API for Business de TikTok renvoie les métriques d'un compte par jour, comme les abonnés, les vues de vidéos, les vues du profil, les j'aime, les commentaires et les partages, sur les 60 derniers jours au plus, ainsi que les chiffres cumulés de chaque vidéo, comme ses vues, j'aime, commentaires et partages. La plupart des chiffres arrivent avec 24 à 48 heures de retard et dépendent de l'activation de TikTok Analytics dans l'application.

easyCoexistence lit les statistiques TikTok avec get_social_insights depuis Claude, ChatGPT ou votre propre code : les abonnés, vues et j'aime du compte par jour, ou les vues, j'aime, commentaires et partages d'une vidéo.

60 days

Historique le plus long pour les métriques quotidiennes d'un compte ; sans dates, l'API renvoie les 7 derniers jours.

24 to 48 h

Délai habituel avant que les chiffres quotidiens et par publication, comme les j'aime, les vues et les partages, soient disponibles.

365 days

Durée après la publication au terme de laquelle les données d'une vidéo cessent de se mettre à jour.

100

Nombre d'abonnés qu'un compte doit atteindre avant que TikTok renvoie la répartition de ses abonnés par âge, sexe et lieu.

Quelles sont les métriques du compte ?

GET /business/get/ renvoie le profil du compte et, pour les dates demandées, une liste de métriques avec une entrée par jour, en UTC :

  • followers_count : le total actuel, et le total de chaque jour.
  • video_views, profile_views, likes, comments et shares : chiffres quotidiens pour l'ensemble des vidéos du compte.
  • unique_video_views, daily_new_followers, daily_lost_followers et engaged_audience : par jour, pour les comptes avec Advanced Access ou les Verified Business Accounts.
  • audience_ages, audience_genders, audience_countries et audience_cities : répartition des abonnés, pour les comptes ayant au moins 100 abonnés.

Quelles sont les métriques vidéo ?

GET /business/video/list/ renvoie les publications publiques du compte avec leurs chiffres cumulés, sans la limite des 60 jours : video_views, likes, comments, shares et favorites, ainsi que la portée, le temps de visionnage total et moyen, le taux de visionnage complet, les nouveaux abonnés et les sources de trafic. Il renvoie jusqu'à 20 publications par page, et filters.video_ids permet d'en isoler certaines.

Quelle est la fraîcheur des données ?

Les champs du profil, comme le nom d'utilisateur et le total actuel d'abonnés, sont en temps réel. Les métriques quotidiennes du compte et les chiffres par publication, comme les vues, j'aime, commentaires et partages, ont généralement 24 à 48 heures de retard, en UTC, et les données d'une publication cessent d'être mises à jour 365 jours après sa publication. La portée, le temps de visionnage et les sources de trafic peuvent manquer pour une vidéo que personne n'a vue, aimée, commentée ni partagée depuis plus de 7 jours.

Pourquoi certaines métriques peuvent-elles manquer ?

L'API renvoie ce que TikTok Analytics a enregistré. Le titulaire du compte doit publier au moins une vidéo et activer Analytics dans l'application TikTok, et les données antérieures à l'activation d'Analytics ne sont pas disponibles. Certaines métriques demandent davantage : la portée et les nouveaux ou perdus abonnés ne sont disponibles que pour les comptes avec Advanced Access ou les Verified Business Accounts, et la répartition des abonnés commence à 100 abonnés.

Pourquoi les chiffres peuvent-ils différer de l'application TikTok ?

À cause de ce qu'ils incluent. video_views additionne les vues organiques et payantes, et shares compte à la fois les partages hors de TikTok et les envois à des amis dans l'application, de sorte qu'il peut être plus élevé que le nombre de partages affiché sur le site de TikTok. Le chiffre des j'aime d'un jour ne retire pas les j'aime retirés plus tard.

Comment easyCoexistence exploite-t-il ces données ?

Avec get_social_insights. Pour le compte, demandez des métriques comme followers_count, video_views et likes, avec un start_date et un end_date : l'outil renvoie les lignes quotidiennes de TikTok. Pour une vidéo, indiquez son item_id comme object_id : il renvoie les vues, j'aime, commentaires et partages, en cherchant parmi les 20 vidéos les plus récentes du compte ; pour une plus ancienne, votre propre code appelle business/video/list/ avec filters.video_ids, en utilisant le token fourni par get_social_credentials.

Erreurs courantes

  • Prendre les chiffres de la veille pour définitifs. Les métriques quotidiennes peuvent avoir 24 à 48 heures de retard, donc les jours récents peuvent encore se compléter.
  • Demander plus de 60 jours de métriques de compte. L'historique s'arrête là : conservez les chiffres si vous avez besoin d'un historique plus long.
  • Chercher une ancienne vidéo par object_id. get_social_insights ne parcourt que les 20 plus récentes ; pour les publications plus anciennes, filtrez par video_ids depuis votre propre code, avec le token fourni par get_social_credentials.
  • Comparer les partages de l'API au compteur du site. L'API compte aussi les envois à des amis dans TikTok, donc son chiffre est plus élevé.
Faire cela avec EasyCoexistence

Pour les autres champs de statistiques TikTok, get_social_credentials donne à votre propre code le token du compte. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.

Questions fréquemment posées

L'API TikTok indique-t-elle combien d'abonnés un compte a perdus ?

Oui, sous la forme de daily_lost_followers, à côté de daily_new_followers, pour les comptes avec Advanced Access ou les Verified Business Accounts.

Jusqu'où remontent les statistiques de compte TikTok ?

60 jours. Sans dates, l'API renvoie les 7 jours jusqu'à la veille de la requête, en UTC.

Quand les données d'une vidéo TikTok cessent-elles d'être mises à jour ?

365 jours après la publication de la vidéo. Jusque-là, ses chiffres cumulés continuent d'être mis à jour, généralement avec 24 à 48 heures de retard.

Les vues des vidéos TikTok incluent-elles les vues payantes ?

Oui. Le chiffre video_views renvoyé par TikTok couvre l'activité organique et payante ensemble.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le