tiktok/
user-playlists

ユーザー名から、TikTokクリエイターのプロフィールに公開されている再生リストを一覧で取得できます。再生リストごとの名前、リンク、カバー画像、動画数、所有者の情報を返します。

TikTok Playlists API

ユーザー名を入力
再生リスト名
再生リストごとの動画数
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

TikTok Playlists

TikTokの再生リストは、クリエイター自身の動画に名前を付けてまとめたもので、連続ストーリー、チュートリアルのシリーズ、定番企画などに使われ、プロフィールにカバー画像と動画数つきで表示されます。ユーザー名で一覧を取得すれば、クリエイターがどんなシリーズを用意していて、それぞれ何本の動画が入っているかがわかります。

TikTok Playlists API の主な機能

  • プロフィールの公開再生リストをすべて取得ユーザー名を送ると、公開されている再生リストが1件ずつレコードになって返ります。上限は results_limit で指定し、範囲は1〜100、デフォルトは20です。
  • item_count でシリーズの厚みがわかるitem_count は再生リストに入っている動画の本数です。長く続いているシリーズと、数本をまとめただけのものを見分けられます。
  • タイトル、カバー、直接リンクtitle、cover_url、再生リストの url が全レコードに付き、author には所有者の id、ユーザー名、アバターが繰り返し入るため、各レコードだけで内容が完結します。

TikTok Playlists API のパラメータ

パラメータ必須説明
username必須再生リストを取得するTikTokのユーザー名です。先頭の@は付けても付けなくてもかまいません。
results_limit任意取得する再生リストの件数です。1〜100の範囲で指定し、デフォルトは20です。

TikTok Playlists API の使い方

ユーザー名を送信して、クリエイターの再生リストを読み取ります。

  1. {"username": "zachking"} を /v1/tiktok/user-playlists に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から再生リストを読み取り、has_more が true の間は results.next_cursor をたどります。
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.

TikTok Playlists API の主なユースケース

  • ジャンル内のシリーズ形式をベンチマーク: 同じカテゴリのクリエイターで title と item_count を比べ、どんなシリーズ形式に力を入れ続けているか、どのくらいの長さで続けているかを把握します。
  • 継続的な提携の前にパートナーを確認: 複数回にわたる企画や継続的な提携を提案する前に、候補のコラボレーターがすでにコンテンツをシリーズとして整理しているか、そのシリーズにどれだけ厚みがあるかを確認します。

TikTok Playlists API 活用のヒント

  • 複数のスナップショットで再生リストを突き合わせるときは、title ではなく id を使ってください。クリエイターは再生リスト名を変更できます。
  • タイトルを読む前に item_count で並べ替えると、そのクリエイターで最も長く続いているシリーズが先頭に来ます。

TikTok Playlists API 以外に別の種類の公開TikTokデータが必要な場合は、これらのAPIをご利用ください。

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Trending Feed API — 地域ごとの現在の公開動画フィードを取得し、クリエイター、キャプション、カバー、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。
  • TikTok Video Transcript API — 公開動画のURLから、取得可能な文字起こしテキスト、言語、形式、取得元の情報を抽出します。
  • TikTok Reposts API — アカウントがリポストした動画を一覧で取得し、それぞれの元の投稿者、キャプション、再生数を返します。

他のプラットフォームを見る

TikTokのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Playlists API — よくある質問

TikTok Playlists APIは、ユーザー名からTikTokクリエイターのプロフィールに公開されている再生リストを一覧取得するためのプログラムインターフェースです。再生リストごとのID、名前、リンク、カバー画像、動画数、所有者の情報を返します。

いいえ。各レコードは再生リストそのものを表し、入っている動画の本数は item_count でわかります。クリエイターの動画は TikTok User Videos で取得してください。

いいえ、別のものです。再生リストはクリエイターが自分の動画をプロフィール上で公開してまとめたもので、こちらが取得の対象です。コレクションは保存した動画を入れる個人用のフォルダで、結果には含まれません。

そのクリエイターに公開の再生リストがないためです。TikTokが再生リストを作れるクリエイターを限っているので、よくあることです。タスクは成功として扱われ、課金されません。返された再生リストは1件につき0.5クレジットです。

同じユーザー名で後日もう一度実行し、再生リストごとの item_count を比べてください。各レコードの collected_at が、そのスナップショットの日時になります。