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 の使い方
既知の公開ハンドルを送信し、非同期タスクの完了を待って、保存されたプロフィールレコードをページ単位で読み取ります。
- 空白を除去し、自前の重複排除のために先頭の @ を取り除いて、公開TikTokユーザー名を選びます。
- usernames と、ユーザー名ごとの results_limit(20〜2,000)を /v1/tiktok/followers-list に POST します。
- task_id を保存して /v1/tasks/{task_id} をポーリングします。queued、running、retrying は通常の中間ステータスです。
- 成功したら 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 trueTikTok 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として扱ってください。
関連API
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 Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live 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 Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API