tiktok/
user-playlists

Listez les playlists publiques du profil de n’importe quel créateur TikTok à partir de son nom d’utilisateur, avec pour chacune son nom, son lien, sa couverture, son nombre de vidéos et les informations sur son propriétaire.

TikTok Playlists API

Nom d’utilisateur en entrée
Noms des playlists
Nombre de vidéos par playlist
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 Playlists

Une playlist TikTok est un groupe nommé de vidéos d’un même créateur, par exemple une histoire en plusieurs parties, une série de tutoriels ou une rubrique récurrente, affiché sur son profil avec une couverture et un nombre de vidéos. Les lister à partir d’un nom d’utilisateur montre quelles séries le créateur a constituées et combien de vidéos chacune contient.

Fonctionnalités de la TikTok Playlists API

  • Toutes les playlists publiques d’un profilEnvoyez un nom d’utilisateur et recevez chaque playlist publique sous forme d’un enregistrement distinct, dans la limite de results_limit, de 1 à 100 (20 par défaut).
  • La profondeur d’une série dans item_countitem_count est le nombre de vidéos de la playlist : une série au long cours se distingue ainsi d’un simple regroupement de quelques clips.
  • Titre, couverture et lien directtitle, cover_url et l’url de la playlist accompagnent chaque enregistrement, et author reprend l’ID, l’identifiant et l’avatar du propriétaire pour que chaque enregistrement reste autonome.

Paramètres de la TikTok Playlists API

ParamètresObligatoireDescription
usernameObligatoireNom d’utilisateur TikTok dont vous voulez lister les playlists, avec ou sans le @ initial.
results_limitFacultatifNombre de playlists à renvoyer, de 1 à 100. 20 par défaut.

Comment utiliser la TikTok Playlists API

Envoyez un nom d’utilisateur et lisez les playlists du créateur.

  1. Envoyez {"username": "zachking"} en POST à /v1/tiktok/user-playlists.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les playlists dans results.items ; suivez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"zachking"}'

# Each item is one playlist with title and item_count.

Cas d’usage de la TikTok Playlists API

  • Comparer les formats de séries dans une niche : Comparez title et item_count entre les créateurs d’une même catégorie pour voir quels formats de séries ils continuent d’alimenter et sur quelle durée.
  • Évaluer un partenaire avant un contrat récurrent : Vérifiez si un collaborateur potentiel organise déjà ses contenus en séries, et jusqu’où elles vont, avant de proposer un partenariat en plusieurs volets ou récurrent.

Conseils d’expert pour la TikTok Playlists API

  • Rapprochez les playlists d’un instantané à l’autre sur id et non sur le titre, car un créateur peut renommer une playlist.
  • Triez par item_count pour placer en tête les séries les plus longues d’un créateur avant de lire les titres.

En complément de la TikTok Playlists 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 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 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 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 Reposts API — Listez les vidéos qu’un compte a repostées, avec l’auteur d’origine, la légende et le nombre de vues de chacune.

Explorer d’autres plateformes

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

TikTok Playlists API — FAQ

TikTok Playlists API est une interface programmatique pour lister les playlists publiques du profil d’un créateur TikTok, à partir de son nom d’utilisateur. Elle renvoie pour chaque playlist son ID, son nom, son lien, sa couverture, son nombre de vidéos et les informations sur son propriétaire.

Non. Chaque enregistrement décrit la playlist elle-même, et item_count indique le nombre de vidéos qu’elle contient. Pour les vidéos du créateur, utilisez TikTok User Videos.

Non. Une playlist est un regroupement public des propres vidéos d’un créateur sur son profil, et c’est ce qui est renvoyé. Les collections sont des dossiers personnels de vidéos enregistrées et ne font pas partie du résultat.

Le créateur n’a aucune playlist publique, ce qui est fréquent puisque TikTok réserve la création de playlists aux créateurs éligibles. La tâche réussit quand même et rien n’est facturé ; chaque playlist renvoyée coûte 0,5 crédit.

Relancez le même nom d’utilisateur plus tard et comparez item_count pour chaque playlist ; collected_at sur chaque enregistrement date l’instantané.