メインコンテンツへスキップ
このガイドでは、リストのメンバーを追加・削除する方法を説明します。
前提条件作業を始める前に、次のものが必要です。
  • 承認済みの App を持つ 開発者アカウント
  • User Access Token (OAuth 1.0a または OAuth 2.0 PKCE)
  • あなたが所有しているリスト

リストにメンバーを追加する

1

リストIDとユーザーIDを取得する

追加したいユーザーのユーザーIDと、対象のリストのIDが必要です。ユーザーIDはuser lookup endpointを使用して取得できます。
2

メンバーを追加する

cURL
curl -X POST "https://api.x.com/2/lists/1441162269824405510/members" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "2244994945"}'
3

レスポンスを確認する

{
  "data": {
    "is_member": true
  }
}

リストからメンバーを削除する

cURL
curl -X DELETE "https://api.x.com/2/lists/1441162269824405510/members/2244994945" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
レスポンス:
{
  "data": {
    "is_member": false
  }
}

重要な注意事項

  • メンバーを管理できるのは、自分が所有しているリストのみです
  • ユーザーをリストに追加する際に、そのユーザーの許可は必要ありません
  • ユーザーは、自分がどの公開リストに追加されたかを確認できます

次のステップ

リストメンバーの取得

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

リストの管理

リストを作成および更新する

APIリファレンス

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