TikTok Followers List
Les listes d’abonnés TikTok visibles publiquement révèlent des identités de comptes, des biographies, des liens de profil et les nombres d’audience ou d’activité disponibles. Ces enregistrements servent à échantillonner une audience, à repérer des créateurs, à alimenter des files d’enrichissement et à suivre de façon récurrente des listes publiques.
Fonctionnalités de la TikTok Followers List API
- Collecte multicompteCollectez les abonnés d’un ou plusieurs noms d’utilisateur publics, results_limit s’appliquant indépendamment à chaque compte envoyé.
- Parcours borné du fluxParcourt en interne les pages d’abonnés prises en charge jusqu’à la limite par compte, l’indisponibilité de la page suivante ou le plafond de collecte.
- Profils normalisésRenvoie l’ID de l’abonné, le nom d’utilisateur, le nom affiché, la biographie, la référence de l’avatar, l’URL du profil et les métriques publiques prises en charge dans une structure de profil cohérente.
- Contexte de la source conservéGarde le nom d’utilisateur envoyé, normalisé, dans extra.input_username pour l’enregistrement d’abonné retenu.
- Contrôle des doublons à l’échelle de la tâcheSupprime les identités d’abonnés répétées au sein de la tâche, d’après l’ID normalisé ou l’URL de profil, avant l’enregistrement et la pagination des résultats.
Paramètres de la TikTok Followers List API
| Paramètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Liste obligatoire et non vide de noms d’utilisateur TikTok publics. Les valeurs peuvent comporter ou non un @ initial ; les ID de compte numériques, les URL de profil et les valeurs de curseur ne sont pas acceptés. |
results_limit | Facultatif | Entier facultatif de 20 à 2 000, 100 par défaut. La limite s’applique séparément à chaque nom d’utilisateur envoyé et constitue un plafond, non une garantie d’exhaustivité. |
Comment utiliser la TikTok Followers List API
Envoyez des handles publics connus, attendez la tâche asynchrone, puis parcourez page par page les profils enregistrés.
- Supprimez les espaces, retirez si besoin les @ initiaux pour votre propre déduplication et choisissez des noms d’utilisateur TikTok publics.
- Envoyez usernames et un results_limit par nom d’utilisateur, de 20 à 2 000, en POST à /v1/tiktok/followers-list.
- Conservez task_id et interrogez /v1/tasks/{task_id} ; queued, running et retrying sont des états intermédiaires normaux.
- Après le succès, lisez data.results.items et transmettez next_cursor au même endpoint de tâche tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok/followers-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@loganpaul"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la TikTok Followers List API
- Échantillonnage d’audience publique : Constituez un échantillon borné de profils d’abonnés visibles publiquement pour un examen qualitatif de l’audience.
- Files de découverte de créateurs : Collectez des noms d’utilisateur et des liens de profil d’abonnés qui peuvent alimenter un examen manuel ou une tâche d’enrichissement ultérieure avec TikTok Profiles.
- Étude récurrente de listes : Enregistrez des échantillons horodatés des mêmes comptes publics pour observer l’évolution des identités disponibles à chaque collecte.
- Entrées pour un annuaire de profils : Transformez les entrées des listes d’abonnés publiques en champs cohérents d’identité, de biographie, d’avatar et de métriques pour des annuaires internes.
Conseils d’expert pour la TikTok Followers List API
- Normalisez la casse et retirez le @ initial avant la déduplication côté client ; sinon @name et name peuvent déclencher des recherches équivalentes à la source.
- Considérez results_limit comme un plafond par nom d’utilisateur : deux noms avec la valeur par défaut de 100 donnent une estimation de 200 résultats, et non de 100.
- Gardez extra.input_username, mais n’utilisez pas cet endpoint pour une analyse exacte des abonnés communs, car la déduplication à l’échelle de la tâche ne retient qu’un contexte source par identité d’abonné.
- Utilisez le nom d’utilisateur de l’abonné, et non l’id numérique, lorsque vous transmettez un compte renvoyé à un endpoint qui accepte des noms d’utilisateur TikTok.
- N’envoyez pas next_cursor dans une nouvelle requête de collecte : il ne sert qu’à parcourir les résultats déjà enregistrés pour la même tâche réussie.
- Traitez les métriques comme nullables et created_at comme null, car les lignes d’abonnés de la source n’exposent pas toujours ces champs.
- Attendez-vous à moins d’enregistrements pour les comptes privés, restreints, indisponibles ou très volumineux, et considérez les références d’avatar comme des URL sources susceptibles d’expirer.
API associées
En complément de la TikTok Followers List 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 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 Audience Demographics API — Découvrez, par nom d’utilisateur, de quels pays viennent les abonnés d’un créateur, avec la part de l’audience de chaque pays.
- 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