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.
Nombre d'abonnés qu'un compte doit atteindre avant que TikTok renvoie ses répartitions par âge, genre, pays et ville.
Tranches d'âge dans audience_ages : 18-24, 25-34, 35-44, 45-54 et 55+.
Fuseau horaire d'audience_activity, le nombre d'abonnés actifs sur TikTok à chaque heure.
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 parcity_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 :
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 :
{
"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.
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.
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