x/
list-followers

公開Xリストを誰がフォローしているかを確認できます。リストのURLを送信すると、各フォロワーのプロフィール文、所在地、認証フラグ、利用開始日、フォロワー数・フォロー数・ポスト数を取得できます。

Twitter List Followers API

リストURLを入力
リストのフォロワー
1リスト最大2,000件
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Twitter List Followers

Xリスト(旧Twitterリスト)のフォロワーは、メンバーのポストを読むためにそのリストをフォローしたアカウントで、それぞれにプロフィール文、所在地、認証状態、利用開始日、フォロワー数・フォロー数・ポスト数を含む公開プロフィールがあります。リストのフォローはそのトピックを追い続けるという意思表示なので、これらのプロフィールからニッチな分野がどんな人を引きつけているかがわかり、関連するリストの読者を比べたり、そのテーマでアプローチする価値のある人を見つけたりできます。

Twitter List Followers API の主な機能

  • あらゆる公開リストのフォロワーx.com/i/lists/<id> のリンクを送信すると、各リストのタイムラインを自らフォローしたアカウントが、1リストにつき最大2,000件返ります。
  • 各フォロワーの人物像各行には username、表示名、text に入ったプロフィール文、アイコン画像、ヘッダー画像、ウェブサイト、location.name が含まれ、リストがどんな人を集めているかがわかります。
  • リーチ、活動量、アカウント歴、認証metrics.followers_count、following_count、posts_count、利用開始日としての published_at、is_verified を使って、定着した活発なフォロワーと、新しいアカウントや活動の少ないアカウントを分けられます。

Twitter List Followers API のパラメータ

パラメータ必須説明
urls必須1つ以上の公開XリストのURLで、いずれも https://x.com/i/lists/<numeric id> の形式です。含めたすべてのリストについてフォロワーが収集されます。
results_limit任意リストごとに収集するフォロワーの件数です。20〜2,000の範囲で20の倍数を指定し、デフォルトは100です。

Twitter List Followers API の使い方

1つ以上のリストURLでタスクを開始し、各リストをフォローしているアカウントをページごとに読み取ります。

  1. {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} を /v1/x/list-followers に POST で送信し、task_id を控えておきます。
  2. status が succeeded になるまで、一定間隔で GET /v1/tasks/{task_id} を呼び出します。
  3. results.items からフォロワーを集め、has_more が true である限り、次の呼び出しで results.next_cursor を渡します。
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Every item is an account that follows the list; the list's members come from /v1/x/list-members.

Twitter List Followers API の主なユースケース

  • 自分のリストのフォロワーを確認: 自分が管理する公開リストのフォロワーを収集し、誰が読んでいるか、followers_count で見てどの読者のオーディエンスが最も大きいかを把握します。
  • トピックのオーディエンス像を描く: 気候テックやSaaS創業者のリストをフォローしている人のプロフィール文と location.name を読み、そのテーマに関心を持つ人物像を描きます。
  • 連絡候補の絞り込み: text 内のキーワードと followers_count でフォロワーを絞り込み、すでに自分の分野の情報を追っているアカウントを選びます。
  • 競合リストの読者比較: 同じテーマの2つのリストのフォロワーを1つのタスクで収集し、id で照合して、共通の読者と各リスト固有の読者を見つけます。
  • 類似オーディエンスのシード作成: よく選び抜かれたリストのフォロワーのユーザー名と id をエクスポートし、広告ツールの類似オーディエンスや興味関心ターゲティングのシードとして使います。

Twitter List Followers API 活用のヒント

  • Twitter List Members API で取得したリストのメンバーとフォロワーを id で照合すると、リストをフォローしているメンバーと、リストの外にいる読者を見つけられます。
  • 比較するすべてのリストで同じ results_limit を使い、各オーディエンスを同じ深さで収集してください。
  • 実行ごとにフォロワーの id を保存しておくと、後日同じリストをエクスポートしたときに、その間に新しくフォローした人がわかります。

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

  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
  • X Following List API — 公開Xアカウントがフォローしているプロフィールを、アカウント情報、プロフィール文、アカウントシグナル、表示中のカウント、元のユーザー名とともに取得します。
  • X Post Retweeters API — 既知のXまたはTwitterのステータスURLをリポストしたアカウントについて、正規化された公開プロフィールをタスク単位で重複なく取得します。
  • X List Tweets API — リストのタイムラインを新しい順に取得し、リポストには元の投稿者を示します。
  • Twitter List Members API — リストのメンバーを、自己紹介、所在地、各種カウントを含むプロフィールとして書き出します。

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

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

Twitter List Followers API — よくある質問

Twitter List Followers APIは、各リストの x.com/i/lists のURLを使って、公開Xリストをフォロー(購読)しているアカウントを収集するためのプログラムインターフェースで、各フォロワーのユーザー名、名前、プロフィール文、所在地、ウェブサイト、認証・非公開のフラグ、利用開始日、フォロワー数・フォロー数・ポスト数を返します。

はい、公開リストであれば確認できます。リストのURLを送信すると、各フォロワーがプロフィールの行として、1リストにつき最大2,000件返ります。

フォロワーはタイムラインを読むためにリストをフォローしたアカウントで、メンバーはリストの作成者が追加したアカウントです。このAPIはフォロワーを返し、メンバーは Twitter List Members API で取得できます。

いいえ。返すのはリストのフォロワーです。ユーザープロフィールをフォローしているアカウントには X Followers List API を使用してください。

小規模なリストはフォロワーが少ないことが多く、結果にはそのリストをフォローしているアカウントがそのまま含まれます。返されたフォロワー1件につき0.7クレジットで、結果が空の場合、料金はかかりません。