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ètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Nom 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.
- Envoyez {"username": "khaby.lame"} en POST à /v1/tiktok/user-audience.
- Interrogez GET /v1/tasks/{task_id} toutes les quelques secondes jusqu’à ce que status vaille succeeded.
- 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é.
API associées
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.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API