tiktok/
following-list

Collectez les profils TikTok publics suivis par un ou plusieurs noms d’utilisateur, avec identité, bios, avatars, métriques visibles et contexte du compte source sous forme d’enregistrements normalisés.

TikTok Following List API

Relations d’abonnement
Enregistrements de profils
Limites par utilisateur
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 Following List

Les listes d’abonnements TikTok contiennent les profils publics qu’un compte suit de façon visible, avec ID d’utilisateur, noms d’utilisateur, noms affichés, biographies, avatars, liens de profil et métriques de compte visibles. Ces enregistrements de relations et de profils servent à étudier les réseaux d’intérêts, à repérer des créateurs, à cartographier les relations publiques et à enrichir des jeux de données de profils.

Fonctionnalités de la TikTok Following List API

  • Relations du compte source vers les profilsCollectez les profils suivis pour chaque nom d’utilisateur public envoyé et conservez le handle source dans extra.input_username.
  • Identité normalisée du profil suiviRenvoie un ID d’utilisateur stable, le nom d’utilisateur, le nom affiché et l’URL canonique du profil TikTok pour chaque membre de relation enregistré.
  • Contexte de profil publicInclut le texte de la biographie, une référence d’avatar et les métriques de compte visibles exposées avec le profil suivi.
  • Collecte bornée par utilisateurApplique results_limit séparément à chaque nom d’utilisateur tout en parcourant les pages de liste disponibles et en dédoublonnant les profils enregistrés selon leur identité stable.

Paramètres de la TikTok Following List API

ParamètresObligatoireDescription
usernamesObligatoireListe obligatoire de noms d’utilisateur TikTok publics non vides. Un @ initial est accepté et supprimé avant la collecte.
results_limitFacultatifNombre maximal d’enregistrements de profils suivis demandés par nom d’utilisateur. Vaut 100 par défaut et accepte les entiers de 20 à 2 000.

Comment utiliser la TikTok Following List API

Envoyez des handles sources publics, puis lisez les profils suivis normalisés dans la tâche asynchrone terminée.

  1. Préparez un ou plusieurs noms d’utilisateur TikTok publics, avec ou sans @ initial, et choisissez pour chacun un results_limit de 20 à 2 000.
  2. Envoyez usernames et results_limit en POST à /v1/tiktok/following-list, puis conservez le task_id renvoyé.
  3. Interrogez GET /v1/tasks/{task_id} tant que la tâche est queued, running ou retrying, et arrêtez-vous lorsqu’elle réussit ou échoue.
  4. Lisez data.results.items après le succès ; tant que has_more vaut true, interrogez la même tâche avec next_cursor pour charger la page suivante des résultats stockés.
curl -X POST "https://api.socq.ai/v1/tiktok/following-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 pass next_cursor while data.results.has_more is true

Cas d’usage de la TikTok Following List API

  • Étude des réseaux d’intérêts : Associez le contexte du compte source aux ID, noms d’utilisateur et biographies des profils suivis pour examiner les centres d’intérêt publics autour d’un compte connu.
  • Découverte de créateurs à partir de comptes de départ : Passez en revue noms affichés, biographies, avatars, liens de profil et métriques visibles pour établir une liste de profils candidats à partir des abonnements publics d’un compte.
  • Enrichissement de jeux de données de profils : Ajoutez ID stables, URL canoniques, biographies publiques, avatars et métriques de compte visibles à des enregistrements de profils identifiés par nom d’utilisateur.

Conseils d’expert pour la TikTok Following List API

  • Retirez le @ initial et dédoublonnez les noms d’utilisateur avant l’envoi, afin que des handles équivalents ne déclenchent pas deux fois le travail sur le compte source.
  • Réglez results_limit pour chaque nom d’utilisateur selon la profondeur voulue ; de longues listes en entrée peuvent produire jusqu’à usernames × results_limit enregistrements, avant fin de liste et déduplication.
  • Utilisez id comme clé de profil principale, repliez-vous sur url s’il est absent, et conservez extra.input_username pour la traçabilité de la source.
  • Voyez dans un résultat vide ou court une conséquence de la visibilité publique, puis vérifiez la confidentialité du compte et la disponibilité de la liste avant de réessayer.
  • N’interprétez pas l’ordre renvoyé comme un signe de récence ou de force de la relation, sauf si vos données en aval fournissent explicitement ce signal.

En complément de la TikTok Following 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 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 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 Following List API — FAQ

TikTok Following List API est une interface qui collecte les profils publics suivis par un ou plusieurs noms d’utilisateur TikTok. Elle renvoie l’identité normalisée du profil, la biographie, l’avatar, les métriques visibles, l’URL canonique et le contexte du compte source.

Envoyez un ou plusieurs handles non vides dans le tableau usernames. Les valeurs peuvent comporter ou non un @ initial, supprimé avant la collecte.

Un enregistrement normalisé peut contenir l’ID, le nom d’utilisateur, le nom affiché, l’URL canonique du profil, la biographie publique, l’avatar et les métriques visibles de l’utilisateur suivi, ainsi que l’heure de collecte et extra.input_username.

results_limit vaut 100 par défaut, accepte les entiers de 20 à 2 000 et s’applique séparément à chaque nom d’utilisateur. Le total enregistré peut être inférieur lorsqu’une liste visible se termine ou que des identités de profil en double sont supprimées.

La confidentialité du compte, les restrictions de la plateforme, des pages de liste indisponibles ou la fin de la liste de relations visible publiquement peuvent réduire les enregistrements renvoyés. Vérifiez la visibilité publique du compte source avant de réessayer.

Non. Considérez l’ordre renvoyé uniquement comme un ordre de collecte, sauf si une source distincte fournit explicitement une notion d’affinité ou de récence.

Chaque profil normalisé enregistré coûte 0,5 crédit. La facturation repose sur le nombre réel d’enregistrements sauvegardés : une tâche vide n’entraîne donc aucun frais par résultat.