tiktok/
song-videos

特定のサウンドを使用した公開TikTok動画を収集し、正規化された動画メタデータ、クリエイターの詳細、キャプション、メディアリンク、エンゲージメント数を返します。

TikTok Song Videos API

音声に紐付く動画
サウンドチャレンジ
トレンドのクラスタリング
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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のリストを非同期タスクとして送信し、正規化された動画結果をページ単位で読み取ります。

  1. music_ids に数値のクリップIDの配列を指定し、任意で results_limit(最大2,000)を指定します。
  2. SocQのAPIキーを使って /v1/tiktok/song-videos に POST リクエストを送信します。
  3. status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
  4. 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に対応付けられます。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Song Videos API — よくある質問

TikTok Song Videos APIは、特定のTikTokサウンドまたは楽曲のクリップIDを使用した公開動画を収集するAPIです。トレンドやチャレンジの分析用に、正規化された動画投稿、投稿者の詳細、キャプション、メディアリンク、表示中のエンゲージメント指標を返します。

music_ids には、TikTokのサウンドページで確認できる数値のクリップIDを文字列にした配列(例:["7439295283975702544"])を指定します。

できます。複数のクリップIDを配列で指定でき、各サウンドが処理されて、集約されたタスク出力として返されます。