x/
following-list

1つ以上のユーザー名がフォローしている公開Xプロフィールを取得し、アカウント情報、プロフィール文、アカウントのシグナル、表示中の各種カウント、取得元アカウントの情報を返します。

X Following List API

フォロー関係
プロフィール情報
アカウントごとの上限
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

X Following List

Xのフォローリストは、取得元アカウントがどのプロフィールをフォローしているかを示す公開のアカウント関係で、アカウント情報、プロフィール文、リンク、画像、アカウントの状態、各種カウント、作成日時を含みます。これらのレコードは、関心ネットワークの調査、アカウントの発見、関係のマッピング、プロフィールデータセットの情報補完に活用できます。

X Following List API の主な機能

  • 複数アカウントのフォロー中リスト取得1つ以上の公開Xユーザー名を受け付け、取得元アカウントごとに上限付きのフォローリスト取得を個別に実行します。
  • プロフィールの基本情報と詳細フォロー先アカウントのID、ユーザー名、表示名、正規URL、プロフィール文、ウェブサイト、所在地、アイコン画像、ヘッダー画像、アカウント作成日時を返します。
  • アカウントのシグナルと公開カウント表示中の認証、非公開、メッセージ、固定ポスト、自動化アカウントの各シグナルを、フォロワー数・フォロー数・ポスト数・メディア数・いいね数とあわせて取得します。
  • 取得元を追跡できる正規化レコード保存された各プロフィールを統一された公開構造で保持し、取得元を追跡できるよう collected_at と extra.input_username を付与します。

X Following List API のパラメータ

パラメータ必須説明
usernames必須必須。空でない公開Xユーザー名の配列です。先頭の @ は付けても付けなくてもかまいません。
results_limit任意ユーザー名ごとにリクエストするフォロー先プロフィールの最大数です。デフォルトは200で、200から2000までの200の倍数を指定できます。

X Following List API の使い方

取得元となる公開ユーザー名を送信し、完了した非同期タスクから正規化されたフォロー先プロフィールのレコードを読み取ります。

  1. 1つ以上の公開Xユーザー名(先頭の @ は任意)を用意し、ユーザー名ごとの results_limit を200から2000までの200の倍数で決めます。
  2. usernames と results_limit を /v1/x/following-list に POST し、返された task_id を保存します。
  3. タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングし、成功または失敗した時点で停止します。
  4. 成功したら data.results.items を読み取り、data.results.has_more が true の間は next_cursor を付けてタスクをリクエストし続けます。
curl -X POST "https://api.socq.ai/v1/x/following-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@X"],"results_limit":200}'

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

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

  • 関心ネットワークの調査: 保持した取得元ユーザー名とフォロー先プロフィールのアカウント情報、プロフィール文、リンク、所在地を結び付け、既知のアカウントを取り巻く公開された関心を分析します。
  • シードプロフィールからのアカウント発見: 取得元プロフィールの公開フォローリストから見つかった候補アカウントを、名前、プロフィール文、画像、認証のシグナル、表示中の各種カウントで評価します。
  • 関係リストの情報補完: ユーザー名ベースの既存の関係レコードに、固定ID、正規プロフィールURL、公開アカウントのメタデータ、各種カウント、取得時刻を追加します。

X Following List API 活用のヒント

  • 同じハンドルで取得元アカウントの処理が重複しないよう、送信前に先頭の @ を取り除き、大文字・小文字を区別せずに取得元ユーザー名の重複を排除してください。
  • results_limit はユーザー名ごとに200単位で設定します。取得元が複数ある場合は、リストの終端やタスク単位の重複排除が適用される前の時点で、最大 usernames × results_limit 件のレコードを見込んでください。
  • 多対多のグラフを構築する場合、取得元とプロフィールの組み合わせごとに1行保存されるとは限りません。繰り返し現れたフォロー先プロフィールは重複排除され、extra.input_username の値が1つしか残らないことがあります。
  • 空のリストや件数の少ないリストは公開範囲による結果として扱い、後続のレコードでは画像、ステータスのシグナル、各種カウントなどの任意項目で null を許容してください。
  • レスポンスが示すのは取得順であり、関係の古さ、交流の強さ、支持を表すものではないため、返された順序をそれらとして解釈しないでください。

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

  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
  • X Post Retweeters API — 既知のXまたはTwitterのステータスURLをリポストしたアカウントについて、正規化された公開プロフィールをタスク単位で重複なく取得します。
  • X Community API — コミュニティのリンクから、説明、メンバー数、ルール、参加ポリシーを取得します。
  • X Account Location API — アカウントの拠点となる国、Xへの接続方法、登録日、ユーザー名の変更回数を確認します。

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

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

X Following List API — よくある質問

X Following List APIは、1つ以上のXユーザー名がフォローしている公開プロフィールを取得するためのプログラムインターフェースです。正規化されたアカウント情報、プロフィール文、リンク、画像、アカウントのシグナル、表示中の各種カウント、タイムスタンプ、取得元の情報を返します。

空でない usernames 配列を送信してください。各公開ハンドルの先頭に @ を付けても付けなくてもかまいません。同等の取得元ユーザー名は、取得元での取得前に大文字・小文字を区別せずに正規化されます。

results_limit のデフォルトは200で、2000までの200の倍数を指定でき、取得元ユーザー名ごとに個別に適用されます。表示されているリストが指定した上限に達する前に終わることもあります。

レコードには、プロフィールID、ユーザー名、表示名、正規URL、プロフィール文、ウェブサイト、所在地、アイコン画像、ヘッダー画像、認証と非公開のシグナル、公開されている各種カウント、アカウント作成日時、取得時刻、extra.input_username が含まれる場合があります。

必ずしもそうではありません。固定のプロフィールIDは結果の保存時に重複排除されるため、複数の送信アカウントがフォローしているプロフィールは、取得元の情報を保持した1件のレコードとして返されることがあります。

非公開または制限されたアカウント、公開範囲の制限、利用できないリストページ、表示中のフォローリストの終端などにより、保存されるレコードが減ることがあります。リトライする前に、取得元アカウントが公開アクセス可能かどうかを確認してください。

いいえ。順序は取得順としてのみ扱ってください。関係がいつ始まったか、アカウント同士がどの程度交流しているか、取得元がフォロー先プロフィールを支持しているかを示すものではありません。

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