TikTok Following List
TikTokのフォロー中一覧には、あるアカウントが公開上フォローしているプロフィールが含まれ、ユーザーID、ユーザー名、表示名、プロフィール文、アバター、プロフィールリンク、表示中のアカウント指標を確認できます。これらの関係・プロフィールレコードは、関心ネットワークの調査、クリエイター発掘、公開関係のマッピング、プロフィールデータセットの情報補完に活用できます。
TikTok Following List API の主な機能
- 取得元からプロフィールへの関係送信した各公開ユーザー名について、フォロー中のプロフィールレコードを収集し、取得元のハンドルを extra.input_username に保持します。
- フォロー先アカウント情報の正規化保存された各関係先について、安定したユーザーID、ユーザー名、表示名、正規のTikTokプロフィールURLを返します。
- 公開プロフィールの情報フォロー先プロフィールとともに公開されているプロフィール文、アバターの参照、表示中のアカウント指標を含めます。
- ユーザーごとの上限付き収集results_limit をユーザー名ごとに個別に適用し、利用可能なリストデータをページ送りしながら、保存するプロフィールを安定した識別子で重複排除します。
TikTok Following List API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
usernames | 必須 | 必須。空でない公開TikTokユーザー名のリストです。先頭の @ は受け付け、収集前に除去されます。 |
results_limit | 任意 | ユーザー名ごとに取得するフォロー先プロフィールレコードの最大数です。デフォルトは100で、20〜2000の整数を指定できます。 |
TikTok Following List API の使い方
取得元となる公開ハンドルを送信し、完了した非同期タスクから正規化されたフォロー先プロフィールのレコードを読み取ります。
- 1つ以上の公開TikTokユーザー名(先頭の @ は任意)を用意し、ユーザー名ごとの results_limit を20〜2000の範囲で選びます。
- usernames と results_limit を /v1/tiktok/following-list に POST し、返された task_id を保存します。
- タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングし、成功または失敗したら停止します。
- 成功したら data.results.items を読み取ります。has_more が true の場合は、同じタスクに next_cursor を指定してリクエストし、保存済み結果の次のページを読み込みます。
curl -X POST "https://api.socq.ai/v1/tiktok/following-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 pass next_cursor while data.results.has_more is trueTikTok Following List API の主なユースケース
- 関心ネットワークの調査: 取得元アカウントの情報とフォロー先のID、ユーザー名、プロフィール文を組み合わせ、既知のアカウントを取り巻く公開上の関心を調べます。
- 起点アカウントからのクリエイター発掘: 表示名、プロフィール文、アバター、プロフィールリンク、表示中の指標を確認し、あるアカウントの公開フォローからプロフィール候補リストを作成します。
- プロフィールデータセットの情報補完: ユーザー名ベースのプロフィールレコードに、安定したID、正規URL、公開プロフィール文、アバター、表示中のアカウント指標を追加します。
TikTok Following List API 活用のヒント
- 送信前に先頭の @ を取り除いてユーザー名の重複を排除し、同等のハンドルで取得元アカウントの処理が重複しないようにしてください。
- results_limit は必要な深さに応じてユーザー名ごとに設定してください。入力リストが大きいと、リストの終端や重複排除の前の段階で最大 usernames × results_limit 件のレコードになる可能性があります。
- id をプロフィールの主キーとして使い、存在しない場合は url で代替し、取得元を追跡できるよう extra.input_username を保持してください。
- 結果が空または少ない場合は公開範囲による結果として扱い、リトライの前にアカウントの公開設定とリストの利用可否を確認してください。
- 下流のデータで明示的にその情報が提供されていない限り、返される順序を新しさや関係の強さとして解釈しないでください。
関連API
TikTok Following List API 以外に別の種類の公開TikTokデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
- TikTok Followers List API — 公開フォロワーリストに表示されているプロフィールを正規化して取得し、取得元の情報と対応する指標を保持します。
- 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