Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Données démographiques des abonnés TikTok via l'API

L'API for Business de TikTok renvoie la démographie des abonnés d'un compte depuis GET /business/get/ : audience_ages, audience_genders, audience_countries et audience_cities, chacune sous forme de liste de parts d'abonnés, pour les comptes ayant au moins 100 abonnés. L'activité horaire des abonnés est fournie sous audience_activity dans les métriques de chaque jour, pour les comptes à Advanced Access ou les Verified Business Accounts comptant au moins 100 abonnés. Tous ces champs nécessitent le scope user.insights.

easyCoexistence lit la démographie des abonnés d'un compte TikTok avec get_social_insights depuis Claude, ChatGPT ou votre propre code : demandez audience_ages, audience_genders, audience_countries, audience_cities ou audience_activity, et il renvoie les listes de TikTok telles quelles.

100

Nombre d'abonnés qu'un compte doit atteindre avant que TikTok renvoie ses répartitions par âge, genre, pays et ville.

5 groups

Tranches d'âge dans audience_ages : 18-24, 25-34, 35-44, 45-54 et 55+.

UTC+0

Fuseau horaire d'audience_activity, le nombre d'abonnés actifs sur TikTok à chaque heure.

24 to 48 h

Délai habituel pour audience_countries, audience_genders et audience_activity, que TikTok calcule hors ligne.

Quelles données démographiques renvoie l'endpoint du compte ?

GET /business/get/ les renvoie lorsqu'elles sont nommées dans fields. Les quatre répartitions figurent en tête de data, une liste par dimension, et l'activité horaire figure dans metrics, un ensemble par jour :

  • audience_ages : la part des abonnés dans chaque tranche d'âge, 18-24, 25-34, 35-44, 45-54 et 55+.
  • audience_genders : la part des abonnés par genre : Female, Male ou Other.
  • audience_countries : la part des abonnés par pays ou région, sous forme de code ISO 3166-1 alpha-2.
  • audience_cities : la part des abonnés par ville, identifiée par city_name.
  • audience_activity : pour chaque jour, les abonnés actifs sur TikTok à chaque heure, sous forme de hour et count.

Comment les demander ?

Avec les noms de champs dans fields, sous forme de tableau JSON, et une plage de dates en UTC pour les métriques quotidiennes qui portent audience_activity. start_date et end_date remontent jusqu'à 60 jours en arrière ; sans eux, TikTok renvoie les 7 jours s'achevant la veille de la requête :

Follower demographics for a TikTok account
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
  --data-urlencode 'start_date=2026-10-24' \
  --data-urlencode 'end_date=2026-10-30'

À quoi ressemble la réponse ?

Chaque répartition est une liste d'objets associant un groupe à son pourcentage, et chaque jour de metrics porte sa date et une liste audience_activity d'heures. Les valeurs ci-dessous sont les exemples de TikTok, réduits à la liste par genre et à quelques heures :

Demographics in the /business/get/ response
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "audience_genders": [
      { "gender": "Female", "percentage": 0.7554470336505679 },
      { "gender": "Male", "percentage": 0.24455296634943213 }
    ],
    "metrics": [
      {
        "date": "<DATE>",
        "audience_activity": [
          { "hour": "20", "count": 1 },
          { "hour": "23", "count": 4 },
          { "hour": "7", "count": 4 }
        ]
      }
    ]
  }
}

Quels comptes obtiennent quelles répartitions ?

Les parts par âge, genre, pays et ville apparaissent dès que le compte compte au moins 100 abonnés ; l'exemple de TikTok pour un compte de 13 abonnés renvoie ces listes vides. audience_activity exige aussi 100 abonnés, et en plus un compte avec Advanced Access, obtenu en le reliant à un compte TikTok for Business ou à un Business Center non vérifié, ou un Verified Business Account. Chacun de ces champs nécessite le scope user.insights sur le token.

Quelle est la fraîcheur des données démographiques ?

Avec un ou deux jours de retard. TikTok range audience_countries, audience_genders et audience_activity parmi les champs qui accusent habituellement 24 à 48 heures de retard, en UTC, et indique le même délai de mise à jour pour les âges et les villes. Les chiffres proviennent de TikTok Analytics, que le titulaire active dans l'application après la publication d'une première vidéo ; les données antérieures à cette activation ne sont pas disponibles. TikTok fonde la démographie sur plusieurs facteurs, dont les informations que les utilisateurs renseignent dans leur profil.

En quoi la démographie des abonnés diffère-t-elle de celle des spectateurs d'une vidéo ?

Elles décrivent des personnes différentes. Les listes du compte portent sur les abonnés. /business/video/list/ renvoie les répartitions des personnes qui ont regardé une publication : audience_genders, audience_countries et audience_cities, jusqu'à 10 entrées chacune, et audience_types, qui répartit les spectateurs entre nouveaux et récurrents, abonnés et non-abonnés. Ces champs nécessitent le scope video.insights au lieu de user.insights.

Comment easyCoexistence les lit-il ?

Avec get_social_insights sur le compte : omettez object_id, listez les noms de champs dans metrics, et passez start_date et end_date dans params lorsque vous voulez audience_activity pour des jours précis. Il renvoie les listes de TikTok telles quelles, de sorte que les parts et les heures se lisent exactement comme ci-dessus.

Follower demographics through MCP
get_social_insights {
  "account_id": "<ACCOUNT_ID>",
  "metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
  "params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}

Erreurs courantes

  • Attendre des répartitions pour un petit compte. TikTok renvoie les parts par âge, genre, pays et ville à partir de 100 abonnés, et son exemple pour un compte de 13 abonnés montre les listes vides.
  • Lire les heures de audience_activity comme heure locale. TikTok les indique en UTC+0 ; décalez-les vers le fuseau horaire de votre audience avant de planifier vos publications.
  • Confondre démographie des abonnés et démographie des spectateurs. Les listes du compte décrivent les abonnés ; audience_countries d'une vidéo décrit les personnes qui l'ont regardée.
  • Attendre audience_activity sur un compte personnel. TikTok le renvoie pour les comptes à Advanced Access ou Verified Business Accounts qui comptent au moins 100 abonnés.
Faire cela avec EasyCoexistence

US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.

Questions fréquemment posées

L'API TikTok peut-elle montrer l'âge et le genre de mes abonnés ?

Oui. /business/get/ renvoie audience_ages et audience_genders, des parts d'abonnés par groupe, dès que le compte compte au moins 100 abonnés et que le token dispose de user.insights.

Quelles tranches d'âge l'API TikTok utilise-t-elle ?

18-24, 25-34, 35-44, 45-54 et 55+, chacune avec la part des abonnés qui s'y trouve.

L'API TikTok indique-t-elle quand mes abonnés sont en ligne ?

audience_activity donne les abonnés actifs sur TikTok par heure, en UTC+0, dans les métriques de chaque jour, pour les comptes à Advanced Access ou Verified Business Accounts comptant 100 abonnés ou plus.

Comment l'API TikTok donne-t-elle les pays des abonnés ?

Sous forme de codes pays ou région ISO 3166-1 alpha-2 dans audience_countries, chacun avec la part des abonnés venant de ce pays.

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