tiktok/
followers-list

Collectez les profils normalisés issus des listes d’abonnés TikTok visibles publiquement pour un ou plusieurs noms d’utilisateur, avec contexte de la source, liens de profil et métriques publiques disponibles.

TikTok Followers List API

Profils d’abonnés
Échantillonnage d’audience
Étude de listes publiques
0,5 crédit par résultat
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 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ètresObligatoireDescription
usernamesObligatoireListe 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_limitFacultatifEntier 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.

  1. Supprimez les espaces, retirez si besoin les @ initiaux pour votre propre déduplication et choisissez des noms d’utilisateur TikTok publics.
  2. Envoyez usernames et un results_limit par nom d’utilisateur, de 20 à 2 000, en POST à /v1/tiktok/followers-list.
  3. Conservez task_id et interrogez /v1/tasks/{task_id} ; queued, running et retrying sont des états intermédiaires normaux.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

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

TikTok Followers List API — FAQ

TikTok Followers List API est une interface qui collecte les profils d’abonnés visibles publiquement pour un ou plusieurs noms d’utilisateur TikTok, avec identité normalisée, biographie, lien de profil et métriques publiques disponibles.

Envoyez un tableau usernames non vide de handles publics, éventuellement précédés de @, et un results_limit facultatif. Les ID numériques de la cible, les URL de profil et les curseurs de collecte ne sont pas acceptés.

C’est un entier de 20 à 2 000, valant 100 par défaut, qui s’applique indépendamment à chaque nom d’utilisateur. Il plafonne la collecte demandée sans garantir ce nombre d’enregistrements publics.

Un enregistrement normalisé contient l’ID, le nom d’utilisateur, le nom affiché, le texte de la biographie, la référence de l’avatar, l’URL du profil, des métriques publiques nullables, collected_at et extra.input_username. created_at vaut actuellement null.

La pagination du flux TikTok est gérée en interne et n’est pas un paramètre d’envoi. Le next_cursor renvoyé après le succès ne charge qu’une autre page de résultats enregistrés depuis /v1/tasks/{task_id}.

Pas de façon fiable. Les résultats enregistrés sont dédoublonnés au sein de la tâche par ID d’abonné ou URL de profil : un abonné répété n’est donc conservé qu’une fois, avec un seul input_username, et non comme un ensemble complet de relations source.

Chaque résultat normalisé enregistré coûte 0,5 crédit, sans frais de base. L’estimation initiale multiplie results_limit par le nombre de noms d’utilisateur envoyés, et les crédits prélevés d’avance puis non utilisés sont remboursés une fois la tâche terminée.