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つ以上の公開Xユーザー名(先頭の @ は任意)を用意し、ユーザー名ごとの results_limit を200から2000までの200の倍数で決めます。
- usernames と results_limit を /v1/x/following-list に POST し、返された task_id を保存します。
- タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングし、成功または失敗した時点で停止します。
- 成功したら 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 trueX Following List API の主なユースケース
- 関心ネットワークの調査: 保持した取得元ユーザー名とフォロー先プロフィールのアカウント情報、プロフィール文、リンク、所在地を結び付け、既知のアカウントを取り巻く公開された関心を分析します。
- シードプロフィールからのアカウント発見: 取得元プロフィールの公開フォローリストから見つかった候補アカウントを、名前、プロフィール文、画像、認証のシグナル、表示中の各種カウントで評価します。
- 関係リストの情報補完: ユーザー名ベースの既存の関係レコードに、固定ID、正規プロフィールURL、公開アカウントのメタデータ、各種カウント、取得時刻を追加します。
X Following List API 活用のヒント
- 同じハンドルで取得元アカウントの処理が重複しないよう、送信前に先頭の @ を取り除き、大文字・小文字を区別せずに取得元ユーザー名の重複を排除してください。
- results_limit はユーザー名ごとに200単位で設定します。取得元が複数ある場合は、リストの終端やタスク単位の重複排除が適用される前の時点で、最大 usernames × results_limit 件のレコードを見込んでください。
- 多対多のグラフを構築する場合、取得元とプロフィールの組み合わせごとに1行保存されるとは限りません。繰り返し現れたフォロー先プロフィールは重複排除され、extra.input_username の値が1つしか残らないことがあります。
- 空のリストや件数の少ないリストは公開範囲による結果として扱い、後続のレコードでは画像、ステータスのシグナル、各種カウントなどの任意項目で null を許容してください。
- レスポンスが示すのは取得順であり、関係の古さ、交流の強さ、支持を表すものではないため、返された順序をそれらとして解釈しないでください。
関連API
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への接続方法、登録日、ユーザー名の変更回数を確認します。
- Twitter Tweet Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API