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 の使い方
まず調査の問いを定め、その上でキーワード、並べ替えの目的、公開期間を選びます。
- 調査テーマを具体的な query に落とし込み、results_limit、sort_by、published_within を選びます。
- リクエストを /v1/tiktok/search に POST し、返された task_id を保存します。
- タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- 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 trueTikTok 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 を保持してください。
- 主要なクエリを定期的に繰り返し実行し、クリエイター、テーマ、エンゲージメントの変化を比較してください。
関連API
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 Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs 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