tiktok/
similar-users

公開TikTokクリエイターのユーザー名から、TikTok自身のおすすめにもとづく類似アカウントを取得できます。ユーザー名、プロフィール文、フォロワー数と動画数、認証状況を返します。

TikTok Similar Accounts API

ユーザー名を入力
TikTokのおすすめ
最大300アカウント
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Similar Accounts

類似アカウントとは、TikTokがあるクリエイターと並べておすすめするプロフィールのことで、ユーザー名、表示名、プロフィール文、認証状況、フォロワー数・フォロー数・動画数が付きます。キーワードの一致ではなくTikTok自身のグループ分けから出た一覧なので、インフルエンサー探しや競合のマッピングで、似たクリエイターを素早くたどる手がかりになります。

TikTok Similar Accounts API の主な機能

  • TikTok自身のおすすめ順1つのユーザー名を送ると、TikTokがそのクリエイターの隣に並べるアカウントが、TikTokのおすすめ順のまま返ります。
  • 全行に規模と信頼度の指標followers_count、following_count、posts_count、is_verified が各アカウントに付くため、プロフィールを1つも開かずに、規模と認証状況で絞り込めます。
  • 起点1つにつき最大300アカウントresults_limit で1〜300件を指定でき(デフォルトは30)、next_cursor でページごとに読み進められます。

TikTok Similar Accounts API のパラメータ

パラメータ必須説明
username必須類似アカウントを探す対象のTikTokユーザー名です。先頭の@は付けても付けなくてもかまいません。
results_limit任意取得する類似アカウントの件数です。1〜300の範囲で指定し、デフォルトは30です。

TikTok Similar Accounts API の使い方

1人のクリエイターを起点に、TikTokがおすすめするアカウントをページごとに取得します。

  1. {"username": "khaby.lame", "results_limit": 30} を /v1/tiktok/similar-users に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からアカウントを読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame","results_limit":30}'

# Each item is one recommended account with username, name and metrics.followers_count.

TikTok Similar Accounts API の主なユースケース

  • 成果の出たクリエイターを起点に候補を広げる: キャンペーンがうまくいったクリエイターを起点に指定し、おすすめされたアカウントのうち followers_count が予算帯に合うものを残します。
  • 競合の起用クリエイターの周辺を知る: 競合ブランドがすでに起用しているクリエイターを起点にして、TikTokが近くに出すアカウントを、規模とあわせて確認します。
  • 重なりからジャンルの輪郭をつかむ: ジャンルの主要アカウントを複数の起点にして結果を統合します。複数の起点にまたがって繰り返し出てくるアカウントが、そのジャンルの中核です。

TikTok Similar Accounts API 活用のヒント

  • 複数の起点の結果を統合するときは、ユーザー名ではなく id で突き合わせてください。関連する起点には同じアカウントが重複して現れ、ユーザー名は変更されることもあるためです。
  • 返ってきたユーザー名を新しい起点にすると、さらに一段階先まで広げられます。新しい結果が手持ちのアカウントの繰り返しばかりになったら、そこで止めましょう。
  • まずはデフォルトの30件で始め、返ってきたアカウントの大半がまだ手持ちにない新しいものであるときだけ results_limit を増やしてください。返されたアカウントはすべて課金対象です。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Followers List API — 公開フォロワーリストに表示されているプロフィールを正規化して取得し、取得元の情報と対応する指標を保持します。
  • TikTok Following List API — TikTokアカウントがフォローしている公開プロフィールを、正規化されたアカウント情報、プロフィール文、表示中の指標、元のアカウント情報とともに取得します。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Audience Demographics API — ユーザー名から、クリエイターのフォロワーがどの国にいるかを、各国がオーディエンスに占める割合とともに確認します。
  • TikTok Live Ranking API — LIVEのデイリークリエイターランキングを、順位、ギフトにもとづくスコア、フォロワー数とともに取得します。

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

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

TikTok Similar Accounts API — よくある質問

TikTok Similar Accounts APIは、公開ユーザー名に対してTikTokが類似としておすすめするアカウントを取得するためのプログラムインターフェースです。各アカウントのユーザー名、表示名、プロフィール文、アバター、認証状況、フォロワー数・フォロー数・動画数を返します。

そのクリエイターのユーザー名を送り、返ってきたアカウントを読み取ってください。TikTokがそのプロフィールに対しておすすめしているアカウントです。followers_count と is_verified で絞り込めば、依頼内容に合うものだけを残せます。

TikTokは基準を公開しておらず、レスポンスにも類似度のスコアはありません。アカウントはTikTokが提供する順に返されるので、近さを示す手がかりは一覧の中での位置だけです。

できません。入力は username と results_limit だけです。返された行は followers_count で自分で絞り込み、候補に残したクリエイターの国は TikTok Audience Demographics で確認してください。

最大300件で、デフォルトは30件です。実際に返されたアカウント1件につき0.5クレジットかかるため、一覧が指定した上限より短ければ、その分料金も下がります。

いいえ、メールのフィールドはありません。取得できるのはテキストのプロフィール文と、プロフィールに記載がある場合のウェブサイトです。