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 の使い方
ユーザー名を送信して、クリエイターの再生リストを読み取ります。
- {"username": "zachking"} を /v1/tiktok/user-playlists に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 で並べ替えると、そのクリエイターで最も長く続いているシリーズが先頭に来ます。
関連API
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 Hashtags API
- TikTok Comments 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 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 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