リストメンバーの取得

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

このガイドでは、リストのメンバーを取得する方法を説明します。

前提条件

始める前に、以下が必要です。

• 承認済みの App を持つ 開発者アカウント
• App のベアラートークン

---

​

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

1. リストIDを確認する

   リストを表示しているときに、URL からリストIDを確認できます：

   https://x.com/i/lists/84839422
                         └── ここがリストIDです
   
2. リストメンバーをリクエストする

   cURL

   shellscript

   curl "https://api.x.com/2/lists/84839422/members?\
   user.fields=created_at,username,verified&\
   max_results=100" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
3. レスポンスを確認する

   {
     "data": [
       {
         "id": "1319036828964454402",
         "name": "Birdwatch",
         "username": "birdwatch",
         "created_at": "2020-10-21T22:04:47.000Z",
         "verified": true
       },
       {
         "id": "1065249714214457345",
         "name": "Spaces",
         "username": "TwitterSpaces",
         "created_at": "2018-11-21T14:24:58.000Z",
         "verified": true
       }
     ],
     "meta": {
       "result_count": 2,
       "next_token": "5349804505549807616"
     }
   }
   

---

​

追加データを取得する

expansions を使用して、ピン留めされた投稿などの関連データを取得します。

cURL

shellscript

curl "https://api.x.com/2/lists/84839422/members?\
user.fields=created_at&\
expansions=pinned_tweet_id&\
tweet.fields=created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

次のステップ

リストメンバーを管理

メンバーの追加と削除

リストの取得

リストの詳細を取得する

APIリファレンス

エンドポイントの完全なドキュメント