tiktok/
followers-list

1つ以上のユーザー名について、公開表示されているTikTokフォロワー一覧から正規化プロフィールを収集し、取得元の情報、プロフィールリンク、利用可能な公開指標とあわせて返します。

TikTok Followers List API

フォロワーのプロフィール
オーディエンスのサンプリング
公開リストの調査
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Followers List

公開表示されているTikTokのフォロワー一覧からは、アカウント情報、プロフィール文、プロフィールリンク、利用可能なオーディエンス数や活動量がわかります。これらのレコードは、オーディエンスのサンプリング、クリエイター発掘、情報補完の対象リスト作成、公開リストの定期調査に活用できます。

TikTok Followers List API の主な機能

  • 複数アカウントからの収集1つ以上の公開ユーザー名についてフォロワーを収集します。results_limit は送信したアカウントごとに個別に適用されます。
  • 上限付きのフィード巡回アカウントごとの上限、次ページが利用できない状態、または収集上限のいずれかに達するまで、サポートされているフォロワーページを内部で巡回します。
  • 正規化されたプロフィールレコードフォロワーのID、ユーザー名、表示名、プロフィール文、アバターの参照、プロフィールURL、サポートされている公開指標を、一貫したプロフィール形式で返します。
  • 取得元情報の保持保持されたフォロワーレコードの extra.input_username に、送信した正規化済みのハンドルを残します。
  • タスク単位の重複制御結果の保存とページネーションの前に、正規化されたIDまたはプロフィールURLで、タスク全体での重複したフォロワーを除外します。

TikTok Followers List API のパラメータ

パラメータ必須説明
usernames必須必須。公開TikTokユーザー名の空でないリストです。先頭の @ は付けても省略してもかまいません。数値のアカウントID、プロフィールURL、カーソル値は受け付けません。
results_limit任意任意。20〜2,000の整数で、デフォルトは100です。上限は送信したユーザー名ごとに個別に適用され、取得件数を保証するものではなく上限値です。

TikTok Followers List API の使い方

既知の公開ハンドルを送信し、非同期タスクの完了を待って、保存されたプロフィールレコードをページ単位で読み取ります。

  1. 空白を除去し、自前の重複排除のために先頭の @ を取り除いて、公開TikTokユーザー名を選びます。
  2. usernames と、ユーザー名ごとの results_limit(20〜2,000)を /v1/tiktok/followers-list に POST します。
  3. task_id を保存して /v1/tasks/{task_id} をポーリングします。queued、running、retrying は通常の中間ステータスです。
  4. 成功したら data.results.items を読み取り、has_more が true の間は同じタスクエンドポイントに next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/followers-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@loganpaul"],"results_limit":100}'

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

TikTok Followers List API の主なユースケース

  • 公開オーディエンスのサンプリング: 公開表示されているフォロワーのプロフィールから、件数を絞ったサンプルを作成し、オーディエンスを定性的に確認します。
  • クリエイター発掘のリスト作成: フォロワーのユーザー名とプロフィールリンクを収集し、手動での確認や、後続の TikTok Profiles による情報補完タスクの起点にします。
  • リストの定期調査: 同じ公開アカウントからタイムスタンプ付きのサンプルを保存し、収集ごとに取得できるアカウントの変化を観察します。
  • プロフィールディレクトリへの入力: 公開フォロワー一覧の項目を、社内ディレクトリ向けに一貫したアカウント情報、プロフィール文、アバター、指標のフィールドへ変換します。

TikTok Followers List API 活用のヒント

  • クライアント側で重複を排除する前に、大文字・小文字を統一し先頭の @ を取り除いてください。そうしないと @name と name が同等の検索として重複実行される場合があります。
  • results_limit はユーザー名ごとの上限として扱ってください。デフォルトの100で2つのユーザー名を指定すると、見積もりは100件ではなく200件になります。
  • extra.input_username は保持してください。ただし、タスク単位の重複排除によりフォロワー1件につき取得元の情報は1つしか残らないため、共通フォロワーの厳密な分析にはこのエンドポイントを使用しないでください。
  • 返されたアカウントをTikTokユーザー名を受け付けるエンドポイントに渡す場合は、数値の id ではなくフォロワーの username を使用してください。
  • next_cursor を新しい収集リクエストで送信しないでください。next_cursor は、同じ成功済みタスクで保存済みの結果をページ送りするためだけのものです。
  • 上流のフォロワー行では常に公開されるとは限らないため、metrics は null になりうるものとして、created_at は null として扱ってください。
  • 非公開、制限付き、利用不可、または非常に大規模なアカウントでは取得件数が少なくなることがあります。また、アバターの参照は有効期限が切れる可能性のあるソースURLとして扱ってください。

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

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

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

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

TikTok Followers List API — よくある質問

TikTok Followers List APIは、1つ以上のTikTokユーザー名から公開表示されているフォロワーのプロフィールを収集するためのプログラムインターフェースで、正規化されたアカウント情報、プロフィール文、プロフィールリンク、利用可能な公開指標を返します。

公開ハンドル(先頭の @ は任意)を含む空でない usernames 配列と、任意の results_limit を送信してください。対象の数値ID、プロフィールURL、収集用のカーソルは受け付けません。

20〜2,000の整数で、デフォルトは100です。ユーザー名ごとに個別に適用されます。リクエストする収集件数の上限であり、その件数の公開レコードが得られることを保証するものではありません。

正規化レコードには、ID、ユーザー名、表示名、プロフィール文、アバターの参照、プロフィールURL、null になりうる公開指標、collected_at、extra.input_username が含まれます。created_at は現在 null です。

TikTokフィードのページネーションは内部で処理され、送信パラメータではありません。成功後に返される next_cursor は、/v1/tasks/{task_id} から保存済み結果の次のページを読み込むためだけに使います。

確実にはできません。保存される結果はタスク内でフォロワーIDまたはプロフィールURLにより重複排除されるため、重複したフォロワーは取得元の関係をすべて保持するのではなく、1つの input_username とともに1回だけ保持されます。

保存された正規化結果1件につき0.5クレジットで、基本料金はかかりません。初期見積もりは results_limit に送信したユーザー名の数を掛けた値で計算され、使われなかった前払いクレジットはタスク完了後に返金されます。