tiktok/
search-music

キーワードでTikTokのサウンドを検索し、それぞれを使った動画の数を確認できます。サウンドID、タイトル、アーティスト、カバー、再生時間、プレビューを返し、関連度・使用数・新着順で並べ替えられます。

TikTok Sound Search API

キーワード検索
サウンドごとの動画数
使用数順に並べ替え
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Sound Search

TikTokのサウンドとは動画に付けられた音声のことで、音楽ライブラリの楽曲もあれば、クリエイターが録音した音声もあり、それぞれに専用ページがあってタイトル、アーティストまたは投稿者、カバー、そのサウンドで作られた動画の累計数が表示されます。この動画数を見れば、そのサウンドがニッチなのか、定番なのか、これから伸びるのかがすぐにわかり、サウンドIDは楽曲とそれを使う動画を結びつける鍵になります。

TikTok Sound Search API の主な機能

  • タイトル、アーティスト、雰囲気で検索query には曲名、アーティスト名、lofi のような雰囲気を表す言葉を指定でき、TikTokが一致と判断したサウンドが返ります。
  • サウンドごとの動画数metrics.videos_count はそのサウンドを使った動画の総数です。定番の曲とニッチな曲を見分けられます。
  • 3種類の並べ替えsort_by で relevance、most_used、latest のいずれかに並べ替えられるため、1つのキーワードで、実績のあるサウンドと新しいサウンドの両方を調べられます。
  • 市場の選択region に2文字の国コードを指定すると、その国のTikTok市場で検索します。デフォルトは US です。
  • プレビュー付きのサウンドレコード各結果には、サウンドページの url、audio.id、title、artist、cover_url、duration_seconds、再生できる audio.url が入ります。

TikTok Sound Search API のパラメータ

パラメータ必須説明
query必須検索する曲名、アーティスト名、またはサウンド名です。
sort_by任意結果の並び順です。relevance(デフォルト)、most_used、latest から指定します。
region任意検索するTikTok市場の2文字の国コードです。デフォルトは US です。
results_limit任意取得するサウンドの件数です。1〜500の範囲で指定し、デフォルトは20です。

TikTok Sound Search API の使い方

キーワードで検索し、一致するサウンドをページごとに取得します。

  1. {"query": "lofi", "results_limit": 20} を /v1/tiktok/search-music に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からサウンドを読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"lofi","sort_by":"most_used","results_limit":20}'

# metrics.videos_count is the number of videos using each sound.

TikTok Sound Search API の主なユースケース

  • ブランド動画向けサウンドの絞り込み: 雰囲気を表すキーワードを sort_by most_used で検索し、videos_count、duration_seconds、音声プレビューを確認して、実績があって動画の長さにも合うサウンドを残します。
  • 新しいサウンドを早い段階で見つける: 同じキーワードを sort_by latest で実行し、videos_count がまだ少ないサウンドを、トレンドのまとめ記事に載る前に押さえます。
  • 楽曲をサウンドIDに結びつける: 曲名をアーティスト名と一緒に検索して audio.artist を照合し、audio.id を控えておけば、そのサウンドを使った動画を追いかけられます。
  • 市場別のサウンドリスト: 同じ query で region のコードを変えて繰り返し、キャンペーンを実施する国ごとに別々の候補リストを作ります。

TikTok Sound Search API 活用のヒント

  • ライセンスされた楽曲は、曲名とアーティスト名を一緒に検索してください。Lofi のような短いタイトルは無関係なサウンドも多数ヒットするため、audio.id を残す前に audio.artist を確認しましょう。
  • 複数のキーワードの検索結果を統合するときは、id で重複を除いてください。1つのサウンドが複数のクエリに一致することがあります。
  • videos_count は累計であって、伸び率ではありません。どのサウンドが勢いを増しているかを知るには、同じクエリを定期的に実行し、実行ごとの件数を比べてください。
  • ファイルが必要な場合は、タスクの完了後すぐに audio.url と cover_url をダウンロードしてください。TikTokは署名付きリンクで配信していて、時間が経つと使えなくなります。

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

  • TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
  • TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
  • TikTok Live Room Info API — ルームIDと配信者IDの組み合わせで既知のライブ配信ルーム1件を検索し、ステータス、配信者情報、カバーメディア、視聴者数を返します。
  • TikTok Song API — クリップIDまたは音楽URLから、公開サウンドのメタデータを取得します。
  • TikTok Song Videos API — 指定したサウンドIDを使用している公開動画を取得します。
  • TikTok Popular Songs API — TikTokアプリのTop 50またはViral 50の楽曲チャートを、曲名、アーティスト、サウンドID、取得可能な動画数とともに取得します。

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

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

TikTok Sound Search API — よくある質問

TikTok Sound Search APIは、曲名、アーティスト、雰囲気などのキーワードでTikTokのサウンドを検索するためのプログラムインターフェースです。各サウンドのID、タイトル、アーティスト、カバー、再生時間、音声プレビュー、そのサウンドを使った動画数を返します。

曲名を検索し、曲名がありふれているときはアーティスト名も加えて、一致した結果の metrics.videos_count を読み取ります。これがそのサウンドで作られた動画の総数です。

いいえ。TikTokアプリの機能は、歌う、鼻歌を聞かせる、曲を流すといった音から曲を判別します。このエンドポイントはテキストで検索し、曲名、アーティスト、雰囲気に一致するサウンドを返すもので、録音した音声から曲を特定することはできません。

sort_by に most_used を指定すると使用数の多いサウンドが先頭に、latest を指定すると新しい順になります。デフォルトの relevance は、キーワードとの一致度が高い順です。

結果から対象のサウンドの id を取り、TikTok Song Videos に渡してください。そのサウンドで投稿された動画を収集できます。

region に2文字の国コードを渡さない限り、USの市場です。渡した場合は、その国のTikTok市場で検索します。

results_limit には1〜500を指定でき、デフォルトは20です。返されたサウンドは1件につき0.6クレジットで、一致しない検索は無料です。