Twitter List Members
X(旧Twitter)のリストのメンバーは、リストの作成者が自ら選んで追加したアカウントで、それぞれに名前、プロフィール文、所在地、ウェブサイト、認証状態、利用開始日、フォロワー数・フォロー数・ポスト数を含む公開プロフィールがあります。その分野に詳しい人がすでに選別を済ませているため、これらのプロフィールは見込み顧客の開拓、インフルエンサー調査、アカウント情報の補完にそのまま使える候補リストになり、定期的にスナップショットを取れば厳選されたグループの変化も記録できます。
Twitter List Members API の主な機能
- リストURLから作成者が選んだアカウントを取得送信した x.com/i/lists/<id> のURLごとに、作成者がリストに登録したアカウントを1リストにつき最大2,000件返し、手作業で選ばれたグループを並べ替えや絞り込みのできる行に変えます。
- メンバーごとの詳細なプロフィール行には username、表示名、text に入ったプロフィール文、アイコン画像とヘッダー画像、ウェブサイト、location.name が含まれ、行を見るだけでアカウントが条件に合うかを判断できます。
- リーチ、活動量、アカウント歴metrics.followers_count、following_count、posts_count で各メンバーのオーディエンスと投稿量がわかり、published_at でアカウントがXの利用を始めた日がわかります。
- 認証と非公開のフラグis_verified と is_private が認証済みメンバーと非公開アカウントを示すため、それぞれのグループを分けて扱えます。
Twitter List Members API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | /i/lists/<numeric id> で終わる公開XリストのURLです(例:https://x.com/i/lists/1940592907737845989)。各リストのメンバーは個別に返ります。 |
results_limit | 任意 | 各リストからエクスポートするメンバーの最大数です。20〜2,000の範囲で20単位で指定し、デフォルトは100です。 |
Twitter List Members API の使い方
エクスポートしたいリストのURLを送信し、タスクが完了したらメンバーのプロフィールを受け取ります。
- x.com から各リストのURLをコピーし、{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} を /v1/x/list-members に POST します。
- 数秒おきに GET /v1/tasks/{task_id} を確認し、ステータスが succeeded になるまで待ちます。
- results.items のメンバープロフィールを保存し、has_more が true の間は results.next_cursor で次のページをリクエストします。
curl -X POST "https://api.socq.ai/v1/x/list-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# Each member's bio is in text and the date the account joined X is in published_at.Twitter List Members API の主なユースケース
- 厳選リストを見込み顧客の候補リストに: フィンテック創業者やAI研究者などのリストをエクスポートし、text のプロフィール文と website が自社の提案に合うメンバーを残してからアプローチします。
- ニッチ分野のアカウントのランク付けと階層分け: metrics.followers_count でメンバーを並べ替え、is_verified や location.name で分けて、影響力の大きいアカウントと地域ごとのグループを切り分けます。
- CRMやリード情報の補完: 各メンバーのアカウント id で照合し、username、website、location.name、プロフィール文を連絡先レコードに追加します。
- リストの変化を記録: 同じリストを定期的にエクスポートし、実行間でメンバーの id を比べて、追加・削除されたアカウントを確認します。
Twitter List Members API 活用のヒント
- ユーザー名は変更できるため、エクスポート間のメンバー照合には id を使ってください。
- メンバーが自分で示している場所は location.name で読み取ってください。場所が表示されていても city、region、country は null の場合があるため、国別にまとめる前に location.name を自分で解析してください。
- results_limit をリストのメンバー数を上回る次の20の倍数に設定すると、1つのタスクでリスト全体をエクスポートできます。課金対象は返されたメンバーだけです。
- 同じリストURLを X List Tweets API に送るとメンバーの投稿内容を、Twitter List Followers API に送るとリストを読んでいる人を確認できます。
関連API
Twitter List Members 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 Account Location API — アカウントの拠点となる国、Xへの接続方法、登録日、ユーザー名の変更回数を確認します。
- X List Tweets 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 Verified Followers 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