tiktok/
profiles

Récupérez les profils TikTok publics d’un ou plusieurs noms d’utilisateur, avec identité normalisée, biographies, avatars, indicateurs de compte et nombres d’audience visibles.

TikTok Profiles API

Enregistrements de créateurs
Résolution d’identité
Instantanés de profils
0,6 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 Profiles

Les profils TikTok sont des pages publiques de créateurs ou de comptes, avec identité, biographies, avatars, statut de vérification et de confidentialité, ainsi que les totaux visibles d’abonnés, d’abonnements, de vidéos et de mentions J’aime. Ces signaux de profil servent à repérer des créateurs, à comparer des audiences, à préparer des partenariats et à enrichir des annuaires.

Fonctionnalités de la TikTok Profiles API

  • Recherche groupée par nom d’utilisateurRésolvez en une seule requête un ou plusieurs noms d’utilisateur de créateurs publics.
  • Noms d’utilisateur normalisés en entréeNormalise les entrées de type nasa et @nasa avant la collecte des profils.
  • Identité de profil stableConstruisez un index d’identité à partir de l’ID du compte, du nom d’utilisateur, du nom affiché et de l’URL du profil.
  • Champs de profil et d’audienceRenvoie dans un même enregistrement la biographie, l’avatar, le statut de vérification et de confidentialité, ainsi que les nombres d’abonnés, d’abonnements, de vidéos et de mentions J’aime au total.
  • Instantanés de profils traçablesTracez chaque enrichissement et chaque instantané récurrent grâce à l’entrée envoyée et à collected_at.

Paramètres de la TikTok Profiles API

ParamètresObligatoireDescription
usernamesObligatoireListe obligatoire de noms d’utilisateur TikTok publics. Chaque valeur peut comporter ou non un @ initial.

Comment utiliser la TikTok Profiles API

Partez d’une liste de noms d’utilisateur de créateurs et produisez des enregistrements prêts pour un annuaire ou un CRM.

  1. Normalisez les entrées de votre liste de créateurs, comme nasa et @nasa, puis dédoublonnez-les.
  2. Envoyez le tableau usernames en POST à /v1/tiktok/profiles et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id}. queued et running sont des états intermédiaires normaux.
  4. Lisez data.results.items après le succès. Tant que has_more vaut true, poursuivez avec next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","@tiktok"]}'

# 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 Profiles API

  • Enrichissement d’un annuaire de talents : Transformez des listes de noms d’utilisateur en fiches de créateurs avec ID de compte, avatars, biographies, statut et indicateurs d’échelle.
  • Préparation de partenariats : Examinez l’identité d’un créateur, son empreinte de publication et la taille de son audience avant de le contacter.
  • Suivi de la croissance des créateurs : Enregistrez des instantanés récurrents des abonnés, des vidéos et des mentions J’aime totales pour une cohorte de créateurs constante.
  • Rapprochement d’identités entre jeux de données : Utilisez les ID de compte pour relier des enregistrements de créateurs aux vidéos et commentaires associés.

Conseils d’expert pour la TikTok Profiles API

  • Utilisez id comme clé du créateur et gardez username pour la recherche et l’affichage.
  • Conservez l’entrée envoyée pour que chaque enregistrement renvoyé se rattache sans ambiguïté à la liste de talents d’origine.
  • Collectez à fréquence fixe et associez chaque instantané de métriques à collected_at.
  • Dédoublonnez sur le nom d’utilisateur après avoir retiré le @ initial.
  • Combinez avatar, display_name, biography et profile_url pour obtenir des fiches de créateurs utiles.
  • Reliez les enregistrements de profils, de vidéos et de commentaires par ID de compte pour obtenir une vue plus riche du créateur.

En complément de la TikTok Profiles API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok.

  • 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 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 Profiles API — FAQ

TikTok Profiles API récupère les profils visibles publiquement pour un ou plusieurs noms d’utilisateur TikTok. Elle renvoie l’identité normalisée, les biographies, les avatars, les indicateurs de vérification et de confidentialité, ainsi que les nombres d’abonnés, d’abonnements, de vidéos et de mentions J’aime.

Placez les noms d’utilisateur publics dans le tableau usernames. Les formats exampleuser et @exampleuser sont tous deux acceptés.

Oui. usernames accepte plusieurs valeurs, traitées dans la même tâche asynchrone et renvoyées sous forme de profils normalisés.

Les résultats comprennent l’ID du compte, le nom d’utilisateur, le nom affiché, l’URL du profil, la biographie publique et l’avatar, ainsi que le statut du compte, la date de création et la région lorsqu’ils sont présents.

Les résultats comprennent les nombres publics d’abonnés, d’abonnements, de vidéos et de mentions J’aime au total, tels qu’observés pendant la collecte.

Les métriques correspondent à l’horodatage collected_at. Enregistrer des résultats récurrents pour les mêmes comptes crée une suite d’instantanés de profils publics.

Utilisez l’ID du compte et le nom d’utilisateur normalisé pour rapprocher les champs de créateur issus de Videos, Search et Hashtags des champs d’auteur issus de Comments.

Chaque profil normalisé renvoyé coûte 0,6 crédit.