注: 戦略的な背景、費用の計算、監視の全体像は、ブログのX List APIガイドを参照してください。
コミュニティの提供状況: APIリファレンスにはコミュニティのエンドポイントが掲載されていますが、現在取得できるデータの確認が必要です。新しい仕組みを作る前にサポートへ連絡し、利用できる操作と結果を確認してください。以下の例はインターフェースの説明であり、現在の稼働確認ではありません。
リスト
Xリストは、最大5,000アカウントをまとめた公開の一覧です。2種類のユーザーが関わります。- メンバー: 作成者がリストに追加したアカウント。
- フォロワー(購読者): リストのタイムラインを読むためにフォローしたユーザー。
リストIDはURL内の数値です。
https://x.com/i/lists/1234567890ならIDは1234567890です。
ヒント: 全アカウントにカード不要・有効期限なしの無料100リクエストがあり、中規模のリストを全体取得できます。API Playgroundではコードなしで試せます。
リストのメンバーを取得する
GET /v3/list-members
リストのフォロワーを取得する
GET /v3/list-followers
パラメーター名に注意してください。
/list-followersはlist_link(URLまたはID)を使い、/list-membersと/list-tweetsはlist_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-followersはusersにプロフィールを返します。/list-tweetsはtweetsにツイートを返し、投稿者はuserに入ります。任意のプロフィール項目は空の場合があります。ツイートを出力するときは、{"username": tweet["user"]["username"]}のように、ネストを明示的に平坦化してください。CSV出力処理はuser.usernameのようなドット区切り名を自動で解釈しません。
関連ガイド
- X List APIガイド:戦略、費用の計算、活用例
- リアルタイム監視:
/list-tweetsの定期取得 - ターゲット層の発見:リストを使ったオーディエンス調査
- マーケティングキャンペーンの確認:メンバー資格の確認
- API利用の最適化:バッチ処理とレート制限対応