tiktok/
song

クリップIDまたはサウンドURLから公開TikTokのサウンド・楽曲の詳細メタデータを収集し、アーティスト、アルバム、再生時間、音声リンク、動画での使用数を返します。

TikTok Song API

サウンドの詳細
音声のメタデータ
楽曲の利用状況
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Song

音楽や音声トラックは、ショート動画のトレンドが拡散する土台となっています。サウンドのメタデータを取得すると、音声のタイトル、アーティストの詳細、音声の長さ、直接再生できるストリームの参照、現在の動画での使用数を確認できます。

TikTok Song API の主な機能

  • 2種類の入力に対応数値のクリップIDで検索することも、公開TikTokサウンドページの完全なURLを指定することもできます。
  • 楽曲とアーティストのメタデータ公式の楽曲タイトル、アーティストのハンドル、ニックネーム、アルバム名、カバーアートのURLを抽出します。
  • 音声のプレビューストリームメディア連携に使える公開音声の再生URLと高精度の再生時間の値を取得できます。
  • 使用数の指標このサウンドを使って作成された公開動画の数を示す user_count カウンターを追跡できます。

TikTok Song API のパラメータ

パラメータ必須説明
music_id必須(いずれか1つ以上)数値のTikTokサウンドクリップIDです(例:7439295283975702544)。url を省略する場合は必須です。
url必須(いずれか1つ以上)公開TikTokサウンド・楽曲ページの直接URLです。music_id を省略する場合は必須です。

TikTok Song API の使い方

サウンドのクリップIDまたは楽曲URLを非同期タスクとして送信し、ポーリングで正規化された楽曲情報を取得します。

  1. 公開TikTok投稿やサウンドの共有リンクから、数値のクリップIDまたはサウンドURLを取得します。
  2. music_id または url のいずれかを指定して、/v1/tiktok/song に POST リクエストを送信します。
  3. 完了するまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を確認し、正規化された楽曲オブジェクトを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/song" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"music_id":"7439295283975702544"}'

# Or pass {"url":"https://www.tiktok.com/music/Different-Acoustic-6717159721276540930"}

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

  • トレンドのライフサイクル追跡: 動画での使用数の推移をモニタリングし、音声トレンドが加速しているのか頭打ちになっているのかを判断します。
  • 音楽カタログの情報補完: アーティストのカタログに、TikTokプラットフォーム上のID、サウンドのカバー画像、音声の長さの情報を追加します。
  • 音声起点のクリエイティブ調査: ショート動画で広く使われているバイラル音声の、元のアーティストと楽曲の詳細を把握します。

TikTok Song API 活用のヒント

  • TikTokの楽曲URLではパスの末尾にクリップIDが含まれています。完全なURLとIDのどちらでも受け付けます。
  • 特定した music_id を TikTok Song Videos に渡すと、この楽曲を使っている動画そのものを取得できます。
  • metrics.videos_count プロパティは、この音声クリップを使用している公開動画の総数を表します。
  • 一般ユーザーが作成したオリジナルサウンドは、extra メタデータの is_original が true になります。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
  • TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Trending Feed API — 地域ごとの現在の公開動画フィードを取得し、クリエイター、キャプション、カバー、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。
  • TikTok Song Videos API — 指定したサウンドIDを使用している公開動画を取得します。

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

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

TikTok Song API — よくある質問

TikTok Song APIは、数値のクリップIDまたはサウンドURLを使って、公開TikTokサウンドのメタデータとクリップの詳細にプログラムからアクセスできるAPIです。楽曲タイトル、アーティスト情報、再生時間、カバーアート、動画での総使用数を標準化された構造で返します。

はい。数値のクリップIDとTikTokの楽曲URLのどちらを指定してもかまいません。値が一致していれば、両方を指定することもできます。

できません。このエンドポイントは既知のサウンドIDまたはURLのメタデータを取得するものです。このサウンドを使っている動画を探す場合は、TikTok Song Videos を使用してください。