tiktok/
user-videos

Collectez les vidéos TikTok publiques d’un ou plusieurs noms d’utilisateur et obtenez légendes, créateurs, médias, horodatages et engagement visible, sous forme d’enregistrements normalisés rattachés au compte.

TikTok User Videos API

Fils de comptes connus
Noms d’utilisateur par lot
Contexte du compte source
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 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ètresObligatoireDescription
usernamesObligatoireListe obligatoire d’un ou plusieurs noms d’utilisateur TikTok publics ; chaque valeur peut comporter ou non un @ initial.
results_limitFacultatifNombre 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_byFacultatifTri facultatif du fil de profil : latest par défaut, ou popular pour des résultats classés par la source.
regionFacultatifCode 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.

  1. 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.
  2. Envoyez usernames et les options facultatives en POST à /v1/tiktok/user-videos, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. 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.

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.

Explorer d’autres plateformes

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

TikTok User Videos API — FAQ

TikTok User Videos API est une interface programmatique qui collecte les vidéos du fil de profil public d’un ou plusieurs noms d’utilisateur TikTok. Elle renvoie l’identité normalisée des vidéos, les légendes, le contexte du créateur et des médias, les horodatages, l’engagement visible et le nom d’utilisateur source.

Transmettez usernames sous forme de tableau non vide. Un @ initial est accepté, mais uniformiser et dédoublonner les identifiants avant l’envoi évite de traiter plusieurs fois le même compte.

results_limit est un maximum par nom d’utilisateur, de 20 à 2 000, avec 100 par défaut. Chaque fil de profil est parcouru séparément et peut s’arrêter avant d’atteindre ce maximum.

latest est le tri par défaut du fil de profil, tandis que popular demande des résultats classés par la source. popular n’est pas un score calculé par SocQ ; conservez donc le tri choisi quand vous comparez des sorties de tâches.

region accepte un code à deux lettres facultatif et peut influer sur les vidéos que la source met à disposition. Il n’indique ni l’endroit où une vidéo a été créée ni la localisation de son audience.

Un enregistrement peut contenir l’identité et l’URL de la vidéo, la légende et la langue, les détails du créateur, l’engagement visible, le média et la durée, les hashtags, les mentions, la musique, les horodatages, les indicateurs publics de contenu et extra.input_username.

Seules les vidéos exposées par le fil de profil public peuvent être renvoyées. Les vidéos privées, restreintes, supprimées ou masquées peuvent manquer, et la collecte s’arrête aussi lorsque le fil se termine, que son curseur n’avance plus ou que le plafond de 100 pages est atteint.

Chaque vidéo normalisée enregistrée coûte 0,5 crédit, sans frais de base par tâche. L’estimation initiale multiplie results_limit, ou sa valeur par défaut, par le nombre de noms d’utilisateur, tandis que la consommation finale suit les enregistrements réellement sauvegardés ; aucune vidéo sauvegardée, aucun frais de résultat.