tiktok/
search

関連度、日付、いいね数、公開期間のフィルターを使って公開TikTok動画をキーワード検索し、正規化されたクリエイター、コンテンツ、メディア、エンゲージメントのレコードを返します。

TikTok Search API

キーワードによる発見
調査用サンプル
期間指定
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Search

TikTokの検索結果は、キーワードやフレーズに一致した公開動画で、クリエイターの詳細、キャプション、メディア、公開情報、表示中のエンゲージメントを含みます。これらのレコードは、トピックの発見、トレンド調査、競合のモニタリング、コンテンツ機会の分析に活用できます。

TikTok Search API の主な機能

  • キーワードによる動画の発見トピック、ブランド、商品、イベントのキーワードから、候補となる動画群を取得します。
  • 関連度順・新着順の並べ替えrelevance、date、likes を切り替えて、トピック性、新しさ、いいね数の多さという観点で結果を見られます。
  • 公開期間の指定day、week、month、three_months、six_months で調査期間を設定できます。
  • コンテンツとクリエイターのフィールド動画、クリエイター、エンゲージメント、ハッシュタグ、音楽のフィールドを一貫した検索結果の構造で返します。
  • 追跡可能な検索スナップショットsearch_query と collected_at により、すべての検索の試行を記録できます。

TikTok Search API のパラメータ

パラメータ必須説明
query必須必須。公開TikTok動画を探すための空でないキーワードです。
results_limit任意取得する動画結果の上限数(正の数)です。デフォルトは100です。
sort_by任意結果の並び順です。relevance、date、likes のいずれかを指定します。デフォルトは relevance です。
published_within任意任意の公開期間です。day、week、month、three_months、six_months のいずれかを指定します。

TikTok Search API の使い方

まず調査の問いを定め、その上でキーワード、並べ替えの目的、公開期間を選びます。

  1. 調査テーマを具体的な query に落とし込み、results_limit、sort_by、published_within を選びます。
  2. リクエストを /v1/tiktok/search に POST し、返された task_id を保存します。
  3. タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取ります。has_more が true の場合は next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • 市場・カテゴリの調査: 商品、カテゴリ、利用シーンに関する語句を使い、TikTok上のコンテンツの全体像とクリエイターのサンプルを把握します。
  • イベントの盛り上がりの追跡: date と day または week の期間を組み合わせ、ローンチ、イベント、ニュースにまつわる最新コンテンツを追跡します。
  • 高いいね数のクリエイティブ調査: likes で並べ替え、繰り返し使われるフック、キャプション、音楽の選び方、ハッシュタグの組み合わせを分析します。
  • ブランド言及のモニタリング: ブランドや商品のクエリを定期的に実行し、コンテンツチームや広報チーム向けにスナップショットを保存します。

TikTok Search API 活用のヒント

  • 広いトピックはブランド、ニーズ、シーン、トレンドのクエリに分割し、得られた動画群を統合してください。
  • トピックの全体像を把握するなら relevance、新しい投稿を追うなら date、人気のクリエイティブ傾向を調べるなら likes を選んでください。
  • 定期レポートなら week のように、published_within でサンプルの時間軸を揃えてください。
  • 検索を再現できるよう、query、sort_by、published_within、collected_at をまとめて保存してください。
  • クエリをまたいで動画の id で重複を排除し、その動画に一致したすべての search_query を保持してください。
  • 主要なクエリを定期的に繰り返し実行し、クリエイター、テーマ、エンゲージメントの変化を比較してください。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
  • TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
  • TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
  • TikTok Live Room Info API — ルームIDと配信者IDの組み合わせで既知のライブ配信ルーム1件を検索し、ステータス、配信者情報、カバーメディア、視聴者数を返します。
  • TikTok Search Users API — キーワードで公開TikTokアカウントを検索します。

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

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

TikTok Search API — よくある質問

TikTok Search APIは、キーワードやフレーズから公開アクセス可能な動画を検索するAPIです。サポートされている並べ替えと期間フィルターを使い、正規化された動画、クリエイター、キャプション、メディア、公開情報、エンゲージメントのデータを返します。

query は必須の空でないキーワードまたはフレーズで、ブランド、商品、キャンペーン、人物、調査テーマなどを指定します。

relevance はトピックとの関連度順、date は新しい投稿を重視、likes は公開いいね数の多さを重視した並びになります。デフォルトは relevance です。

published_within には day、week、month、three_months、six_months を指定でき、それぞれ対応する直近期間に公開された動画が対象になります。

results_limit はリクエストする動画結果の上限で、正の整数を指定します。デフォルトは100です。

結果には、動画ID、正規URL、キャプション、言語、公開日時、クリエイター、公開エンゲージメント、ハッシュタグ、メンション、メディア、音楽のデータが含まれます。

search_query には結果を生んだ検索語、collected_at には取得日時が記録され、検索スナップショットを追跡できます。

返された正規化検索動画結果1件につき0.7クレジットです。