tiktok/
user-audience

Voyez dans quels pays vivent les abonnés d’un compte TikTok public à partir de son seul nom d’utilisateur, avec pour chaque pays son nom, son code ISO, sa part de l’audience et le nombre d’abonnés échantillonnés.

TikTok Audience Demographics API

Nom d’utilisateur en entrée
Pays des abonnés
Part par pays
20 crédits par requête
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 Audience Demographics

La répartition par pays de l’audience d’un compte TikTok indique où vivent ses abonnés : chaque pays y figure avec sa part dans un échantillon d’abonnés et le nombre d’abonnés échantillonnés derrière cette part. Les statistiques natives de TikTok réservent cette vue au titulaire du compte, et une recherche par nom d’utilisateur permet donc aux marques, aux agences et aux analystes de vérifier un créateur qu’ils ne gèrent pas.

Fonctionnalités de la TikTok Audience Demographics API

  • Tout nom d’utilisateur public, sans connexionEnvoyez un nom d’utilisateur public, avec ou sans @, et obtenez la géographie de ses abonnés sans accès au compte ni session TikTok.
  • Nom, code ISO, part et effectifChaque entrée de audience_countries contient le nom du pays, un country_code à deux lettres, une part comprise entre 0 et 1 et le nombre d’abonnés échantillonnés sur lequel elle repose.
  • Le plus grand marché en premierLes pays sont classés par part décroissante : les premières lignes montrent où se trouve l’essentiel de l’audience, et la fin de liste révèle les marchés plus modestes.

Paramètres de la TikTok Audience Demographics API

ParamètresObligatoireDescription
usernameObligatoireNom d’utilisateur TikTok à analyser, avec ou sans le @ initial.

Comment utiliser la TikTok Audience Demographics API

Envoyez un nom d’utilisateur, interrogez la tâche, puis lisez un enregistrement d’audience.

  1. Envoyez {"username": "khaby.lame"} en POST à /v1/tiktok/user-audience.
  2. Interrogez GET /v1/tasks/{task_id} toutes les quelques secondes jusqu’à ce que status vaille succeeded.
  3. Lisez l’unique enregistrement de results.items et parcourez audience_countries.
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame"}'

# The result has one record; audience_countries[].share is a fraction from 0 to 1.

Cas d’usage de la TikTok Audience Demographics API

  • Réserver un créateur pour un seul marché : Avant de financer une campagne visant un pays précis, lisez la part de ce pays dans les abonnés du créateur : une grande communauté installée ailleurs n’atteindra pas vos acheteurs.
  • Vérifier qu’une action de ciblage géographique porte ses fruits : Si vous cherchez à bâtir une audience dans un nouveau pays, interrogez le même nom d’utilisateur à intervalles réguliers et comparez la part de ce pays d’un horodatage collected_at à l’autre.
  • Écarter les marchés que vous ne pouvez pas servir : Les boutiques et les applications qui ne vendent que dans une liste fermée de pays peuvent additionner les parts de ces valeurs de country_code et écarter les créateurs dont les abonnés vivent surtout ailleurs.

Conseils d’expert pour la TikTok Audience Demographics API

  • Divisez count par share pour estimer la taille de l’échantillon d’abonnés ; quand il est réduit, considérez les pays aux parts voisines comme à égalité plutôt que classés.
  • Regroupez les valeurs de country_code en zones qui vous sont propres, par exemple l’UE ou l’Amérique latine, avant de comparer des créateurs : une campagne vise le plus souvent une zone plutôt qu’un pays isolé.

En complément de la TikTok Audience Demographics 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 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 Similar Accounts API — Trouvez les comptes que TikTok recommande comme similaires à un nom d’utilisateur, avec nombres d’abonnés et bios.
  • TikTok Live Ranking API — Obtenez le classement quotidien des créateurs LIVE, avec rangs, scores fondés sur les cadeaux et nombres d’abonnés.

Explorer d’autres plateformes

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

TikTok Audience Demographics API — FAQ

TikTok Audience Demographics API est une interface programmatique pour récupérer, à partir d’un nom d’utilisateur, les pays où vivent les abonnés d’un compte TikTok public. Elle renvoie un enregistrement qui liste le nom de chaque pays, son code ISO, sa part de l’audience et le nombre d’abonnés échantillonnés.

Oui, pour tout compte public. TikTok ne montre la localisation des abonnés qu’au titulaire du compte, alors que cette recherche n’exige que le nom d’utilisateur.

Non. L’enregistrement ne couvre que le pays des abonnés, sans répartition par âge, par sexe ni par ville.

Envoyez votre propre nom d’utilisateur et lisez les pays sous forme de données, sans ouvrir TikTok Analytics ; c’est pratique pour des rapports qui couvrent plusieurs comptes que vous gérez.

Chaque part provient d’un échantillon des abonnés du compte, et count indique combien d’abonnés échantillonnés la sous-tendent. Un pays dont le count est faible donne un signal approximatif, pas un chiffre précis.

Il s’applique par requête. Un nom d’utilisateur coûte 20 crédits forfaitaires, quel que soit le nombre de pays renvoyés ; si le nom d’utilisateur n’existe pas, la tâche échoue et les crédits sont restitués.