tiktok/
search-users

キーワードで公開TikTokクリエイターやアカウントを検索し、正規化されたプロフィールのアカウント情報、フォロワー数、プロフィール文を収集します。

TikTok Search Users API

クリエイター検索
正規化されたプロフィール
タレント発掘
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Search Users

キーワードで公開クリエイターアカウントを検索すると、ニッチなインフルエンサー、ブランドのプロフィール、トレンドトピックのクリエイターを幅広く発見できます。正規化されたアカウントレコードには、プロフィールのハンドル、表示名、プロフィール文、取得時点のフォロワー数が含まれ、タレントの選定に活用できます。

TikTok Search Users API の主な機能

  • キーワードによるアカウント発見任意の検索文字列を送信して、公開TikTokアカウント、クリエイターのハンドル、関連するコミュニティのプロフィールを見つけられます。
  • 正規化されたクリエイタープロフィールユーザー名、表示名、アバター、プロフィール文、認証済みアカウントのバッジを含む構造化レコードを取得できます。
  • オーディエンス指標取得時点の、表示中のフォロワー数、フォロー数、投稿動画の総数を抽出します。
  • 設定可能な結果上限内部のカーソルページネーションを自動で行い、最大2,000人のクリエイターまで結果件数を制御できます。

TikTok Search Users API のパラメータ

パラメータ必須説明
query必須一致する公開TikTokクリエイターアカウントを探すための検索キーワードまたは名前です。
results_limit任意返すクリエイタープロフィールの最大数です。デフォルトは100で、1〜2,000の範囲で指定できます。

TikTok Search Users API の使い方

検索クエリを非同期タスクとして送信し、タスクのポーリングで正規化されたクリエイターレコードを取得します。

  1. 検索クエリのキーワードと、任意の results_limit(最大2,000)を選びます。
  2. SocQのAPIキーを使って /v1/tiktok/search-users に POST リクエストを送信します。
  3. status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items から正規化されたプロフィール項目を取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"taylor swift","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.

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

  • インフルエンサー・クリエイターの選定: 特定のニッチ分野で関連性の高いクリエイターを見つけ、現在のオーディエンス指標を評価します。
  • ブランドモニタリングと偽アカウントの検出: ブランド名で検索し、非公式アカウント、なりすまし、ファンコミュニティを見つけます。
  • タレントデータベースの構築: 最新のクリエイターのアカウント情報とフォロワーのメタデータを、CRMや分析プラットフォームに取り込みます。

TikTok Search Users API 活用のヒント

  • 具体的なニッチ分野のキーワードやハンドルの一部を使うと、検索結果を効果的に絞り込めます。
  • results_limit の値を大きくすると、上流の複数ページを自動でページ送りして取得します。
  • is_verified の真偽値を確認すると、認証済みの著名人アカウントとファンページを区別できます。
  • 上位に一致したアカウントについては、続けて TikTok User Videos を使い、最近のコンテンツのパフォーマンスを分析してください。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
  • TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
  • TikTok Followers List API — 公開フォロワーリストに表示されているプロフィールを正規化して取得し、取得元の情報と対応する指標を保持します。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Live Room Info API — ルームIDと配信者IDの組み合わせで既知のライブ配信ルーム1件を検索し、ステータス、配信者情報、カバーメディア、視聴者数を返します。

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

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

TikTok Search Users API — よくある質問

TikTok Search Users APIは、TikTok上の公開クリエイターアカウントやプロフィールをキーワードで発見できるAPIです。ユーザーのセッション認証なしで、正規化されたユーザー名、表示名、フォロワー数、アカウントの認証フラグを返します。

必要ありません。すべてのリクエストはSocQのAPIキーで認証され、TikTokの公式開発者アカウントやユーザーのOAuthは不要です。

TikTok Search エンドポイントはクエリに一致する公開動画の投稿を返すのに対し、TikTok Search Users はクリエイターアカウントやチャンネルのプロフィールを見つけることに特化しています。