tiktok/
following-list

1つ以上のユーザー名がフォローしている公開TikTokプロフィールを収集し、アカウント情報、プロフィール文、アバター、表示中の指標、取得元アカウントの情報を正規化レコードとして返します。

TikTok Following List API

フォロー関係
プロフィールレコード
ユーザーごとの上限
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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. 1つ以上の公開TikTokユーザー名(先頭の @ は任意)を用意し、ユーザー名ごとの results_limit を20〜2000の範囲で選びます。
  2. usernames と results_limit を /v1/tiktok/following-list に POST し、返された task_id を保存します。
  3. タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングし、成功または失敗したら停止します。
  4. 成功したら 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 true

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

  • 関心ネットワークの調査: 取得元アカウントの情報とフォロー先のID、ユーザー名、プロフィール文を組み合わせ、既知のアカウントを取り巻く公開上の関心を調べます。
  • 起点アカウントからのクリエイター発掘: 表示名、プロフィール文、アバター、プロフィールリンク、表示中の指標を確認し、あるアカウントの公開フォローからプロフィール候補リストを作成します。
  • プロフィールデータセットの情報補完: ユーザー名ベースのプロフィールレコードに、安定したID、正規URL、公開プロフィール文、アバター、表示中のアカウント指標を追加します。

TikTok Following List API 活用のヒント

  • 送信前に先頭の @ を取り除いてユーザー名の重複を排除し、同等のハンドルで取得元アカウントの処理が重複しないようにしてください。
  • results_limit は必要な深さに応じてユーザー名ごとに設定してください。入力リストが大きいと、リストの終端や重複排除の前の段階で最大 usernames × results_limit 件のレコードになる可能性があります。
  • id をプロフィールの主キーとして使い、存在しない場合は url で代替し、取得元を追跡できるよう extra.input_username を保持してください。
  • 結果が空または少ない場合は公開範囲による結果として扱い、リトライの前にアカウントの公開設定とリストの利用可否を確認してください。
  • 下流のデータで明示的にその情報が提供されていない限り、返される順序を新しさや関係の強さとして解釈しないでください。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Following List API — よくある質問

TikTok Following List APIは、1つ以上のTikTokユーザー名がフォローしている公開プロフィールを収集するためのプログラムインターフェースです。正規化されたプロフィールのアカウント情報、プロフィール文、アバター、表示中の指標、正規URL、取得元アカウントの情報を返します。

1つ以上の空でないハンドルを usernames 配列で送信してください。先頭の @ は付けても省略してもかまわず、収集前に除去されます。

正規化レコードには、フォロー先ユーザーのID、ユーザー名、表示名、正規プロフィールURL、公開プロフィール文、アバター、表示中のプロフィール指標、取得日時、extra.input_username が含まれる場合があります。

results_limit はデフォルトが100で、20〜2000の整数を指定でき、ユーザー名ごとに個別に適用されます。公開リストが終端に達した場合や重複するプロフィールが除去された場合は、保存される合計件数が少なくなることがあります。

アカウントの公開設定、プラットフォームの制限、リストページが利用できない状態、または公開されている関係リストの終端により、返されるレコードが少なくなることがあります。リトライの前に、取得元アカウントの公開状況を確認してください。

いいえ。別のソースが親密度や新しさの意味を明示的に提供していない限り、返される順序は収集順としてのみ扱ってください。

保存された正規化プロフィールレコード1件につき0.5クレジットです。課金は実際に保存されたレコード数に基づくため、結果が空のタスクには結果単位の料金はかかりません。