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ètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Liste 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.
- Normalisez les entrées de votre liste de créateurs, comme nasa et @nasa, puis dédoublonnez-les.
- Envoyez le tableau usernames en POST à /v1/tiktok/profiles et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id}. queued et running sont des états intermédiaires normaux.
- 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 trueCas 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.
API associées
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.
- 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