x/
list-members

リストのURLから、公開Xリストに登録されたアカウントをエクスポートします。各メンバーのユーザー名、プロフィール文、所在地、ウェブサイト、認証状態、フォロワー数・フォロー数・ポスト数を返します。

Twitter List Members API

リストURLを入力
作成者が追加したアカウント
メンバーの詳細なプロフィール
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を送信し、タスクが完了したらメンバーのプロフィールを受け取ります。

  1. x.com から各リストのURLをコピーし、{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} を /v1/x/list-members に POST します。
  2. 数秒おきに GET /v1/tasks/{task_id} を確認し、ステータスが succeeded になるまで待ちます。
  3. 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 に送るとリストを読んでいる人を確認できます。

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 — リストのタイムラインを新しい順に取得し、リポストには元の投稿者を示します。

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

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

Twitter List Members API — よくある質問

Twitter List Members APIは、各リストの x.com/i/lists のURLを使って公開Xリストに属するアカウントをエクスポートするためのプログラムインターフェースで、メンバーごとにユーザー名、名前、プロフィール文、所在地、ウェブサイト、認証・非公開のフラグ、利用開始日、フォロワー数・フォロー数・ポスト数を含むプロフィールを返します。

x.com でリストのURLをコピーし、results_limit とともに urls に入れて送信します。完了したタスクからメンバーのプロフィールを読み取り、has_more が true の間は next_cursor をたどってください。各メンバーはJSONレコードなので、スプレッドシートやCRMに書き込めます。

はい。公開リストであれば、作成者が誰であってもURLからエクスポートできます。

1リストにつき最大2,000人で、results_limit で20単位で指定します。デフォルトは100です。複数のリストを送信した場合、上限はそれぞれのリストに適用されます。

返されたメンバー1人につき0.7クレジットなので、メンバー100人のリストなら70クレジットです。結果が空の場合、料金はかかりません。