tiktok/
popular-songs

TikTokのTop 50またはViral 50の楽曲チャートを取得し、楽曲名、アーティスト、サウンドID、取得可能な動画数から、確認用の楽曲リストを作成できます。

TikTok Popular Songs API

Top 50
Viral 50
サウンドID
結果1件あたり0.5クレジット
準備完了
README

SocQ 編集 · 更新

TikTok Popular Songs

TikTokのサウンドとは投稿に付けられた音声のことで、TikTokアプリにはTop 50とViral 50の楽曲チャートがあります。返される各レコードはタイトル、アーティスト、サウンドIDで特定のサウンドを識別するため、楽曲リストを作成し、各項目をサウンドの詳細やそのサウンドを使った動画に結び付けられます。

TikTok Popular Songs API の主な機能

  • 2つの楽曲チャートから選択chart_type に top を指定するとTop 50、viral を指定するとViral 50になります。いずれもTikTokアプリにある名前付きのチャートで、確認したいほうを選び、最大50件までリクエストできます。
  • 楽曲タイトルの裏にあるサウンドを特定タイトル、アーティスト、サウンドID、カバー画像、再生時間をまとめて確認できます。サウンドIDを使うと同名の音声クリップを区別でき、TikTok Song や TikTok Song Videos でその特定のサウンドを検索できます。
  • 取得可能なサウンドの使用数を確認ソースが数値を提供している場合、metrics.videos_count でそのサウンドを使っている動画の数がわかります。これは動画数であり、リスナー数、再生数、いいね数ではありません。取得できない場合は null のままです。

TikTok Popular Songs API のパラメータ

パラメータ必須説明
chart_type任意任意。チャートの選択です。top はTikTokアプリのTop 50、viral はViral 50を選択します。デフォルトは top です。たとえば、例の値を viral に変更すると、もう一方のチャートをリクエストできます。
results_limit任意任意。楽曲の最大数で、1〜50の整数を指定します。デフォルトは20です。たとえば10を指定すると、選択したチャートから最大10件をリクエストします。ソースから返される件数がこれより少ない場合があり、結果のページネーションでこの上限が増えることはありません。

TikTok Popular Songs API の使い方

リクエストを送るとバックグラウンドの収集タスクが開始されるため、最初のレスポンスでは完成したデータではなくタスクIDが返されます。そのIDを使って進行状況を確認し、結果を取得します。

  1. chart_type を選びます。Top 50なら top、Viral 50なら viral です。省略した場合は top が使われます。results_limit のデフォルトは20で、1〜50の整数を指定できます。
  2. $SOCQ_API_KEY をご自身のAPIキーに置き換えるか、その環境変数を設定します。Authorization ヘッダーを付けてJSONリクエストを POST /v1/tiktok/popular-songs に送信し、返された task_id を保存します。
  3. 収集はバックグラウンドで実行されるため、最初のレスポンスにはタスクIDが含まれます。GET /v1/tasks/{task_id} を照会してください。queued、running、retrying はタスクがまだ進行中であることを示します。succeeded になったら結果を読み取り、failed の場合は error_message を確認します。
  4. data.results.items を読み取ります。各項目は特定のサウンドを表し、audio.id がサウンドID、audio.artist がアーティスト名、metrics.videos_count が取得可能な動画での使用数です。items 配列が空の場合は、レコードが返されなかったことを意味します。
  5. data.results.has_more が true の場合は、next_cursor をそのまま cursor として GET /v1/tasks/{task_id}?cursor=... に渡し、has_more が false になるまで続けます。これは同じ保存済みタスクの別ページを読み取るもので、チャートの収集上限が50を超えることはありません。
curl -X POST "https://api.socq.ai/v1/tiktok/popular-songs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chart_type":"top","results_limit":20}'

TikTok Popular Songs API の主なユースケース

  • 楽曲確認シートの作成: Top 50またはViral 50を選び、タイトル、アーティスト、サウンドID、再生時間、取得可能な動画数を表にエクスポートします。チームでサウンドページを開き、どのクリップがコンテンツの企画に合うかを確認できます。
  • サウンドを使った動画の事例収集: 返されたサウンドIDを music_ids として TikTok Song Videos に渡し、公開動画の事例を収集します。クリップの使われ方を把握するには、それらの動画をご自身で確認してください。このチャートAPIはその分析を行いません。
  • 個別に収集したチャートスナップショットの比較: タスクを実行するたびに、選択した chart_type、サウンドID、取得可能な動画数、collected_at を保存します。保存した表をサウンドIDで結合すると、返された楽曲と使用数の推移を比較できます。API自体は過去のランキングを提供しません。

TikTok Popular Songs API 活用のヒント

  • 保存した実行結果を比較する際は、chart_type を統一してください。top から viral に切り替えると選択するチャート自体が変わるため、楽曲リストが異なるだけでは人気の上昇や下降を示すことにはなりません。
  • audio.id を使って、タスクをまたいでレコードを結び付けたり、TikTok Song や TikTok Song Videos にリクエストしたりしてください。タイトルだけでは同名の異なるサウンドクリップを区別できません。
  • audio.url が null の場合は、追加調査のためにサウンドIDと公開サウンドページのURLを保持してください。音声URLが提供された場合は、恒久的なダウンロード先ではなく、取得時点で利用可能なメディアリンクとして扱ってください。

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

  • TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Trending Feed API — 地域ごとの現在の公開動画フィードを取得し、クリエイター、キャプション、カバー、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。
  • TikTok Video Transcript API — 公開動画のURLから、取得可能な文字起こしテキスト、言語、形式、取得元の情報を抽出します。
  • TikTok Song API — クリップIDまたは音楽URLから、公開サウンドのメタデータを取得します。
  • TikTok Song Videos API — 指定したサウンドIDを使用している公開動画を取得します。

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

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

TikTok Popular Songs API — よくある質問

TikTok Popular Songs APIは、TikTokアプリのTop 50またはViral 50の楽曲チャートを読み取るためのプログラムインターフェースです。chart_type と結果の上限を選ぶと、サウンド名、アーティスト、サウンドID、カバー画像、再生時間、取得可能な動画での使用数を取得できます。

TikTokアプリにある2つの名前付きチャートを選択するもので、top はTop 50、viral はViral 50です。chart_type を省略した場合は top が使われます。レスポンスではランキングの算出方法の説明や成長スコアは提供されません。

選べません。このインターフェースで受け付けるのは chart_type と results_limit、およびタスク完了通知用の任意の callback_url です。国、チャート期間、新規ランクイン、商用音楽のフィルターは提供していません。

できません。results_limit は1〜50の範囲です。結果カーソルは、そのタスクですでに保存されたレコードの別ページを読み取るためのもので、チャートの項目を追加で収集するものではありません。

metrics.videos_count は、そのサウンドを使用していると報告されている動画の数です。リスナー数、再生数、いいね数を表すものではありません。null はソースがその数値を提供しなかったことを意味し、0 は実際に返された値です。

楽曲レコードの audio.id を取得し、music_ids に入れて TikTok Song Videos に渡してください。1つのサウンドの詳細を取得する場合は、そのIDを TikTok Song で使用します。これらは別々のリクエストです。

含まれるとは限りません。名前、アーティスト、サウンドIDが取得できていても、audio.url が null になることがあります。URLが返された場合は、取得可能な音声の確認に使えますが、リンクに引き続きアクセスできることはAPIでは保証されません。

返された楽曲レコード1件につき0.5クレジットで、基本料金はかかりません。上限を20にした場合の見積もりは10クレジットで、タスクが12曲を返した場合の最終的な請求は6クレジットです。上限を50にした場合の見積もりは25クレジットです。