TikTok Song Videos
共通の音声トラックに紐付く動画投稿を追跡すると、クリエイターがバイラルチャレンジやトレンドのBGMをどのように解釈しているかがわかります。正規化された動画項目には、サウンドのクラスターごとに、クリエイター情報、キャプション、再生リンク、表示中のエンゲージメント指標が含まれます。
TikTok Song Videos API の主な機能
- サウンド起点の動画収集1つ以上の数値のサウンドクリップIDを送信し、その音声で公開された動画を収集します。
- クリエイターと投稿の情報返される各動画について、クリエイターのユーザー名、ニックネーム、キャプション全文、ハッシュタグ、メンションを取得します。
- エンゲージメントの内訳再生数、いいね数、コメント数、シェア数、保存数を抽出し、同じ楽曲を使った動画同士のパフォーマンスを比較できます。
- メディアのダウンロードリンクカバー画像と動画ストリームの直接URLを、サイズと再生時間のメタデータとともに取得できます。
TikTok Song Videos API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
music_ids | 必須 | 公開動画を収集する対象の、数値のTikTokサウンドクリップIDの配列です。 |
results_limit | 任意 | サウンドIDごとに返す動画の最大数です。デフォルトは100で、1〜2,000の範囲で指定できます。 |
TikTok Song Videos API の使い方
サウンドクリップIDのリストを非同期タスクとして送信し、正規化された動画結果をページ単位で読み取ります。
- music_ids に数値のクリップIDの配列を指定し、任意で results_limit(最大2,000)を指定します。
- SocQのAPIキーを使って /v1/tiktok/song-videos に POST リクエストを送信します。
- status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、追加のページは next_cursor で取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/song-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"music_ids":["7439295283975702544"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.TikTok Song Videos API の主なユースケース
- バイラルサウンドキャンペーンの分析: ブランドのサウンドやプロモーション用の音声トラックが、クリエイターのコミュニティにどの程度効果的に広がっているかを評価します。
- クリエイティブのパターン調査: 同じ音声スニペットを使うクリエイターが採用している、共通の映像フォーマット、振り付け、寸劇を分析します。
- 高パフォーマンスUGCの発見: 特定のトレンド音楽に関連する、パフォーマンスの高いユーザー生成動画を見つけ、ライセンス取得やコラボレーションに活用します。
TikTok Song Videos API 活用のヒント
- 数値の music_id は、TikTok Song エンドポイントまたはTikTokの楽曲WebページURLの末尾から取得してください。
- 結果は、プラットフォームのサウンドフィードに応じて新しい順または人気順で返されます。
- results_limit でサウンドごとの結果数に上限を設定してください。複数IDのタスクでは、サウンドIDごとに個別にページ送りされます。
- 各動画項目の extra.clip_id を確認すると、項目を入力したサウンドIDに対応付けられます。
関連API
TikTok Song Videos API 以外に別の種類の公開TikTokデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
- TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
- TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
- TikTok Trending Feed API — 地域ごとの現在の公開動画フィードを取得し、クリエイター、キャプション、カバー、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。
- TikTok Video Transcript API — 公開動画のURLから、取得可能な文字起こしテキスト、言語、形式、取得元の情報を抽出します。
- TikTok Song API — クリップIDまたは音楽URLから、公開サウンドのメタデータを取得します。
- TikTok Profiles API
- TikTok Hashtags 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 Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists 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