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でタスクを開始し、各リストをフォローしているアカウントをページごとに読み取ります。
- {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} を /v1/x/list-followers に POST で送信し、task_id を控えておきます。
- status が succeeded になるまで、一定間隔で GET /v1/tasks/{task_id} を呼び出します。
- 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 を保存しておくと、後日同じリストをエクスポートしたときに、その間に新しくフォローした人がわかります。
関連API
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 — リストのメンバーを、自己紹介、所在地、各種カウントを含むプロフィールとして書き出します。
- Twitter Tweet Scraper API
- Twitter User Tweets 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 API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified 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