TikTok User Videos
Les vidéos TikTok d’un compte sont les publications du fil de profil public, avec leurs légendes, l’identité du créateur, le contexte média et sonore, les détails de publication et l’engagement visible. Ces enregistrements de contenu rattachés à un compte servent à inventorier les créateurs, à comparer les rythmes de publication, à étudier les créations et à prendre des instantanés de performance.
Fonctionnalités de la TikTok User Videos API
- Fils de profil de comptes connusAcceptez un ou plusieurs noms d’utilisateur TikTok et parcourez chaque fil vidéo public séparément, en limitant les résultats aux comptes choisis plutôt qu’à une découverte par mot-clé ou par hashtag.
- Détails de la vidéo et du créateurRenvoie les ID et URL des vidéos, les légendes, la langue, l’identité du créateur, les références média, la durée, les hashtags, les mentions, la musique et les indicateurs publics de contenu.
- Engagement horodatéAssocie les nombres visibles de vues, de mentions « J’aime », de commentaires, de partages, de favoris et de reposts aux dates de publication et de collecte, pour des enregistrements vidéo de compte à un instant donné.
- Parcours maîtrisé par compteApplique à chaque nom d’utilisateur un tri par récence ou par popularité et, au choix, une région, tout en dédoublonnant les ID de vidéos et en respectant la limite demandée par compte.
Paramètres de la TikTok User Videos API
| Paramètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Liste obligatoire d’un ou plusieurs noms d’utilisateur TikTok publics ; chaque valeur peut comporter ou non un @ initial. |
results_limit | Facultatif | Nombre maximal de vidéos demandées pour chaque nom d’utilisateur ; vaut 100 par défaut et accepte des entiers de 20 à 2 000. |
sort_by | Facultatif | Tri facultatif du fil de profil : latest par défaut, ou popular pour des résultats classés par la source. |
region | Facultatif | Code de région à deux lettres facultatif, transmis en majuscules pour influer sur la disponibilité côté source. |
Comment utiliser la TikTok User Videos API
Envoyez des noms d’utilisateur publics connus sous forme de tâche asynchrone, puis lisez les vidéos normalisées rattachées aux comptes grâce à la pagination par curseur des résultats.
- Préparez un ou plusieurs noms d’utilisateur TikTok publics, puis choisissez le tri latest ou popular, une région à deux lettres facultative et un results_limit par nom d’utilisateur.
- Envoyez usernames et les options facultatives en POST à /v1/tiktok/user-videos, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- Lisez data.results.items depuis /v1/tasks/{task_id}?limit=50 et poursuivez avec results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok/user-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@loganpaul"],"results_limit":20,"sort_by":"latest"}'
# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.Cas d’usage de la TikTok User Videos API
- Inventaires vidéo de créateurs : Indexez les comptes choisis par ID de vidéo, URL canonique, légende, média, date de publication et extra.input_username pour tenir un catalogue de contenus publics traçable.
- Comparaison des publications et de l’engagement : Confrontez created_at aux vues, mentions « J’aime », commentaires, partages, favoris et reposts visibles de comptes connus, en gardant collected_at comme heure de l’instantané.
- Étude des formats créatifs : Servez-vous des légendes, de la langue, de la durée, des hashtags, des mentions, de la musique, du type de média et des indicateurs publics pour repérer les schémas créatifs récurrents dans des fils de profil sélectionnés.
Conseils d’expert pour la TikTok User Videos API
- Uniformisez chaque identifiant sous une seule forme et dédoublonnez avant l’envoi : creator et @creator désignent le même compte, mais pourraient sinon être traités séparément.
- Choisissez results_limit en tenant compte du nombre de noms d’utilisateur, car la limite et l’estimation initiale de crédits s’appliquent séparément à chaque compte envoyé.
- Utilisez latest pour une collecte axée sur la récence, et voyez dans popular l’ordre de la source, non un score calculé par SocQ.
- N’employez region que comme levier de disponibilité ; n’y voyez pas la preuve qu’une vidéo renvoyée a été produite dans cette zone géographique.
- Pour fusionner des tâches répétées, dédoublonnez sur l’id de la vidéo en gardant extra.input_username et collected_at, afin d’attribuer chaque vidéo à son compte et de dater l’instantané.
- Considérez comme nullables les champs facultatifs du créateur, de l’engagement, du média, de la musique et des indicateurs de contenu, échappez les légendes publiques avant de les afficher et ne supposez pas que les URL de médias sources sont permanentes.
API associées
En complément de la TikTok User Videos 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 Comments API — Collectez les commentaires publics de premier niveau, leurs auteurs, l’engagement, les mentions et les indicateurs d’interaction du créateur.
- TikTok Videos API — Récupérez le créateur, la légende, les médias, la musique, les tags, les mentions et l’engagement à partir d’URL de vidéos.
- TikTok Trending Feed API — Collectez le fil actuel de vidéos publiques d’une région avec créateur, légende, couverture, horodatage et engagement visible.
- TikTok Video Transcript API — Extrayez le texte de transcription disponible, la langue, le format et le contexte source à partir d’URL de vidéos publiques.
- TikTok Song API — Récupérez les métadonnées d’un son public à partir de l’ID du clip ou de l’URL du morceau.
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts 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 Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API