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を使って進行状況を確認し、結果を取得します。
- chart_type を選びます。Top 50なら top、Viral 50なら viral です。省略した場合は top が使われます。results_limit のデフォルトは20で、1〜50の整数を指定できます。
- $SOCQ_API_KEY をご自身のAPIキーに置き換えるか、その環境変数を設定します。Authorization ヘッダーを付けてJSONリクエストを POST /v1/tiktok/popular-songs に送信し、返された task_id を保存します。
- 収集はバックグラウンドで実行されるため、最初のレスポンスにはタスクIDが含まれます。GET /v1/tasks/{task_id} を照会してください。queued、running、retrying はタスクがまだ進行中であることを示します。succeeded になったら結果を読み取り、failed の場合は error_message を確認します。
- data.results.items を読み取ります。各項目は特定のサウンドを表し、audio.id がサウンドID、audio.artist がアーティスト名、metrics.videos_count が取得可能な動画での使用数です。items 配列が空の場合は、レコードが返されなかったことを意味します。
- 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が提供された場合は、恒久的なダウンロード先ではなく、取得時点で利用可能なメディアリンクとして扱ってください。
関連API
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 Profiles API
- TikTok Hashtags API
- TikTok Comments 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 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