tiktok/
search-insights

TikTokのCreator Search Insightsのデータを、言語とカテゴリを指定して取得できます。0〜100の人気度スコア、7点の推移、動画数が付いた人気の検索と、コンテンツギャップの絞り込みに対応します。

TikTok Creator Search Insights API

人気度スコア
コンテンツギャップの絞り込み
12言語
1リクエストあたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Creator Search Insights

Creator Search Insightsは、人々が何を検索しているかをTikTokが示すリストで、各検索ワードに0〜100の人気度スコア、短い推移ライン、すでに作られている動画の本数が付いています。よく検索されているのに動画が少ないワードはコンテンツギャップとして示され、需要が供給を上回っている領域や、関心が高まっているのか冷めているのかが、クリエイターやブランドにわかります。

TikTok Creator Search Insights API の主な機能

  • 0〜100の人気度popularity は、TikTokのリスト内の他の検索と比べた各検索のスコアなので、ワード同士の順位をそのまま比較できます。
  • 7点の推移popularity_trend は直近の7つのスコアを古い順に返し、尺度は popularity と同じ0〜100です。
  • コンテンツギャップの絞り込みfilter_by に content_gap を指定すると、関心が高いのに動画が少ない検索が返り、該当する検索には labels に content_gap が入ります。
  • 需要と供給を1件にvideos_count はTikTokがその検索に関連づけた動画の本数、category はコンテンツ領域の名前で、関心の高さと競合の多さが1件のレコードに収まります。
  • 12言語、6カテゴリlanguage には en、id、de、es、fr、pt、vi、tr、ar、th、ja、ko を指定でき、category で gaming、fashion、tourism、science、food、sports のいずれかに絞り込めます。

TikTok Creator Search Insights API のパラメータ

パラメータ必須説明
language任意取得する検索の言語です。デフォルトは en です。
category任意検索を1つのコンテンツカテゴリ(gaming、fashion、tourism、science、food、sports)に限定します。
filter_by任意all は人気の検索(デフォルト)、content_gap はまだ動画が少ない検索です。

TikTok Creator Search Insights API の使い方

言語、カテゴリ、絞り込みを選んで、検索ワードを読み取ります。

  1. {"language": "en", "category": "food", "filter_by": "content_gap"} を /v1/tiktok/search-insights に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items の20件の検索を、TikTokのリスト順のまま読み取ります。
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"en","category":"food","filter_by":"content_gap"}'

# popularity is 0-100; popularity_trend lists recent scores oldest first.

TikTok Creator Search Insights API の主なユースケース

  • コンテンツギャップを軸にした動画企画: カテゴリの content_gap の検索を取得し、popularity が高く videos_count が少ないワードを選びます。
  • 週次トピックレポートの作成: カテゴリごとに定期実行してリストを保存し、週ごとにどの検索が新しく入り、上がり、圏外に落ちたかを見ます。
  • 言語別のオーディエンスの比較: 同じカテゴリを2〜3言語で取得して、コンテンツをローカライズする前に、各市場でどのトピックが先行しているかを確認します。
  • TikTok SEOキーワードの種: リストをもとに動画を作るときは、各結果の keyword をキャプション、画面上のテキスト、タイトルに使います。

TikTok Creator Search Insights API 活用のヒント

  • popularity の比較は1回のレスポンスの中で行い、言語とカテゴリの組み合わせごとに別のリストとして扱ってください。
  • 取得のたびに collected_at を保存してください。このエンドポイントが返すのは現在のリストだけなので、前週との変化は手元に残したスナップショットから読み取ることになります。
  • 有望なキーワードは TikTok Search に渡し、すでに上位に出ている動画を確認してから、どう差をつけるかを決めましょう。

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

  • TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
  • TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
  • TikTok Live Room Info API — ルームIDと配信者IDの組み合わせで既知のライブ配信ルーム1件を検索し、ステータス、配信者情報、カバーメディア、視聴者数を返します。
  • TikTok Search Users API — キーワードで公開TikTokアカウントを検索します。
  • TikTok Hashtag Views API — 最大20個のハッシュタグについて、動画の総数と総再生数をまとめて照会します。
  • TikTok Trending Searches API — TikTokで今日トレンドになっている検索ワードを、ランキング順に取得します。

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

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

TikTok Creator Search Insights API — よくある質問

TikTok Creator Search Insights APIは、TikTokのCreator Search Insightsに表示される人気の検索を、言語、カテゴリ、コンテンツギャップで絞り込んで取得するためのプログラムインターフェースです。各検索の人気度スコア、7点の推移、動画数、カテゴリ、ラベルを返します。

いいえ。popularity は検索同士を比べて順位づけするための0〜100の相対スコアで、検索が何回行われたかはわかりません。

よく検索されているのに、動画の本数がまだ比較的少ない検索のことです。filter_by に content_gap を指定すると(category は付けても付けなくても可)、そうした検索だけがリストに入ります。

popularity_trend を見てください。7つのスコアが古い順に入っていて、最後の値が最初より高ければ関心が高まっており、低ければ冷めています。

できません。このエンドポイントが返すのは、指定した言語、カテゴリ、絞り込みについてTikTokがリストアップした検索で、ワードを指定しての照会ではありません。そのワードですでに上位に出ているものを見るには、TikTok Search に渡してください。

language は en、id、de、es、fr、pt、vi、tr、ar、th、ja、ko で、デフォルトは en です。category は gaming、fashion、tourism、science、food、sports で、省略もできます。

リクエスト1回につき20件の検索を、一律1クレジットで返す仕様です。もっと多くのワードを見たいときは、language、category、filter_by を変えてください。組み合わせごとに別のリストが返ります。

ありません。リクエストに必要なのはAPIキーと、任意の language、category、filter_by だけで、TikTokのログインも使いません。