tiktok/
user-playlists

Die öffentlichen Playlists im Profil eines TikTok-Creators per Benutzername auflisten – mit Name, Link, Titelbild, Videozahl und Angaben zum Besitzer jeder Playlist.

TikTok Playlists API

Benutzername als Eingabe
Playlist-Namen
Videozahl je Playlist
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

TikTok Playlists

Eine TikTok-Playlist ist eine benannte Gruppe aus eigenen Videos eines Creators, etwa eine in Teilen erzählte Geschichte, eine Tutorial-Reihe oder eine wiederkehrende Rubrik, im Profil mit Titelbild und Videozahl angezeigt. Wer sie per Benutzername auflistet, sieht, welche Reihen ein Creator zusammengestellt hat und wie viele Videos jede enthält.

Funktionen der TikTok Playlists API

  • Jede öffentliche Playlist eines ProfilsSenden Sie einen Benutzernamen und erhalten Sie jede öffentliche Playlist als eigenen Datensatz, höchstens so viele wie results_limit, das von 1 bis 100 reicht und standardmäßig 20 beträgt.
  • Umfang der Reihe in item_countitem_count ist die Zahl der Videos in der Playlist, sodass eine lang laufende Reihe sich von einer Gruppe aus wenigen Clips abhebt.
  • Titel, Titelbild und direkter Linktitle, cover_url und die url der Playlist gehören zu jedem Datensatz, und author wiederholt ID, Handle und Avatar des Besitzers, damit jeder Datensatz für sich vollständig bleibt.

Parameter der TikTok Playlists API

ParameterErforderlichBeschreibung
usernameErforderlichDer TikTok-Benutzername, dessen Playlists aufgelistet werden, mit oder ohne führendes @.
results_limitOptionalWie viele Playlists zurückgegeben werden, von 1 bis 100. Standard ist 20.

So verwenden Sie die TikTok Playlists API

Senden Sie einen Benutzernamen und lesen Sie die Playlists des Creators aus.

  1. Senden Sie {"username": "zachking"} per POST an /v1/tiktok/user-playlists.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Playlists aus results.items; folgen Sie results.next_cursor, solange has_more true ist.
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.

Anwendungsfälle der TikTok Playlists API

  • Serienformate in einer Nische vergleichen: Vergleichen Sie title und item_count von Creatorn einer Kategorie, um zu sehen, in welche Serienformate sie weiter investieren und wie lange sie eine Reihe durchhalten.
  • Einen Partner vor einer laufenden Zusammenarbeit prüfen: Prüfen Sie, ob ein möglicher Kooperationspartner seine Inhalte schon in Reihen ordnet und wie umfangreich diese sind, bevor Sie eine mehrteilige oder wiederkehrende Partnerschaft vorschlagen.

Profi-Tipps zur TikTok Playlists API

  • Ordnen Sie Playlists zwischen Momentaufnahmen über id zu und nicht über den Titel, denn ein Creator kann eine Playlist umbenennen.
  • Sortieren Sie nach item_count, damit die am längsten laufenden Reihen eines Creators oben stehen, bevor Sie die Titel lesen.

Ergänzend zur TikTok Playlists API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.

  • TikTok Profiles API — Öffentliche Profilidentität, Bios, Kontomerkmale und Zahlen zur Zielgruppe per Benutzername abrufen.
  • TikTok Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
  • TikTok User Videos API — Öffentliche Videos aus dem Profil-Feed per Benutzername erfassen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, Interaktionen und Kontext des Quellkontos.
  • TikTok Trending Feed API — Den aktuellen öffentlichen Video-Feed einer Region erfassen – mit Feldern zu Creator, Bildunterschrift, Cover, Zeitstempel und sichtbaren Interaktionen.
  • TikTok Video Transcript API — Verfügbaren Transkripttext, Sprache, Format und Quellkontext aus öffentlichen Video-URLs extrahieren.
  • TikTok Reposts API — Die Videos auflisten, die ein Konto repostet hat – jeweils mit ursprünglichem Autor, Beschreibung und Aufrufzahl.

Weitere Plattformen entdecken

Kombinieren Sie TikTok-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok Playlists API — FAQ

TikTok Playlists API ist eine Schnittstelle zum Auflisten der öffentlichen Playlists im Profil eines TikTok-Creators anhand seines Benutzernamens. Sie liefert zu jeder Playlist ID, Name, Link, Titelbild, Videozahl und Angaben zum Besitzer.

Nein. Jeder Datensatz beschreibt die Playlist selbst, und item_count nennt, wie viele Videos sie enthält. Die Videos des Creators erhalten Sie mit TikTok User Videos.

Nein. Eine Playlist ist die öffentliche Gruppierung eigener Videos eines Creators im Profil, und genau die wird zurückgegeben. Sammlungen sind persönliche Ordner mit gespeicherten Videos und gehören nicht zum Ergebnis.

Der Creator hat keine öffentlichen Playlists, was häufig vorkommt, weil TikTok das Anlegen von Playlists auf berechtigte Creator beschränkt. Die Aufgabe ist trotzdem erfolgreich und es wird nichts berechnet; jede zurückgegebene Playlist kostet 0,5 Credits.

Fragen Sie denselben Benutzernamen später erneut ab und vergleichen Sie item_count jeder Playlist; collected_at in jedem Datensatz datiert die Momentaufnahme.