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を非同期タスクとして送信し、ポーリングで正規化された楽曲情報を取得します。
- 公開TikTok投稿やサウンドの共有リンクから、数値のクリップIDまたはサウンドURLを取得します。
- music_id または url のいずれかを指定して、/v1/tiktok/song に POST リクエストを送信します。
- 完了するまで /v1/tasks/{task_id} をポーリングします。
- 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 になります。
関連API
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 Hashtags API
- TikTok Comments API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Video Transcript 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