Skip to main content
Sorsa APIで、公開Xリストのメンバー、フォロワー、ツイートフィードを取得します。このページでは、APIリファレンスにあるコミュニティのリクエスト形式も説明します。新しいワークフローで使う前に、提供状況の注記を確認してください。
注: 戦略的な背景、費用の計算、監視の全体像は、ブログのX List APIガイドを参照してください。
コミュニティの提供状況: APIリファレンスにはコミュニティのエンドポイントが掲載されていますが、現在取得できるデータの確認が必要です。新しい仕組みを作る前にサポートへ連絡し、利用できる操作と結果を確認してください。以下の例はインターフェースの説明であり、現在の稼働確認ではありません。

リスト

Xリストは、最大5,000アカウントをまとめた公開の一覧です。2種類のユーザーが関わります。
  • メンバー: 作成者がリストに追加したアカウント。
  • フォロワー(購読者): リストのタイムラインを読むためにフォローしたユーザー。
非公開リストにはAPIからアクセスできません。 リストIDはURL内の数値です。https://x.com/i/lists/1234567890ならIDは1234567890です。
ヒント: 全アカウントにカード不要・有効期限なしの無料100リクエストがあり、中規模のリストを全体取得できます。API Playgroundではコードなしで試せます。

リストのメンバーを取得する

GET /v3/list-members
5,000メンバーのリスト全体は約25リクエストで取得できます。

リストのフォロワーを取得する

GET /v3/list-followers パラメーター名に注意してください。/list-followerslist_link(URLまたはID)を使い、/list-members/list-tweetslist_id(数値IDのみ)を使います。

リストのツイートを取得する

GET /v3/list-tweets 全メンバーの最近の投稿を1つの時系列フィードで返します。リアルタイム監視では、アカウントを個別に確認する代わりに、1リクエストでグループを追跡するために使います。

コミュニティ

以下は、APIリファレンスのコミュニティ用リクエスト形式です。利用前に、上記の注記に従って提供状況を確認してください。 メンバーデータが利用できれば、参加情報はオーディエンスを探す手がかりになります。ただし参加だけでは最近の活動状況は分かりません。 コミュニティIDはURL内の数値です。https://x.com/i/communities/1966045657589813686ならIDは1966045657589813686です。 非公開コミュニティはAPIからアクセスできませんでした。

コミュニティのメンバーを取得する

POST /v3/community-members 簡略プロフィール(ID、ユーザー名、表示名、アバター、認証状態、非公開状態)を返します。

コミュニティのツイートを取得する

POST /v3/community-tweets

コミュニティ内のツイートを検索する

POST /v3/community-search-tweets
全メンバーをページネーションで取得せず、個別の参加確認だけを行う場合は、専用の/check-community-memberを使ってください。

CSVに出力する

上記のリスト用エンドポイントのユーザー・ツイートフィードは、1つのヘルパーで出力できます。ユーザーの例:
/list-members/list-followersusersにプロフィールを返します。/list-tweetstweetsにツイートを返し、投稿者はuserに入ります。任意のプロフィール項目は空の場合があります。ツイートを出力するときは、{"username": tweet["user"]["username"]}のように、ネストを明示的に平坦化してください。CSV出力処理はuser.usernameのようなドット区切り名を自動で解釈しません。

関連ガイド