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 の使い方
検索クエリを非同期タスクとして送信し、タスクのポーリングで正規化されたクリエイターレコードを取得します。
- 検索クエリのキーワードと、任意の results_limit(最大2,000)を選びます。
- SocQのAPIキーを使って /v1/tiktok/search-users に POST リクエストを送信します。
- status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
- 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 を使い、最近のコンテンツのパフォーマンスを分析してください。
関連API
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 Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Following List 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