メインコンテンツへスキップ
List Members エンドポイントを使用すると、リストのメンバーを表示したり、リストにメンバーを追加したり削除したりできます。また、ユーザーがどのリストのメンバーであるかも確認できます。

概要

メンバーを表示

リスト内のすべてのメンバーを取得

メンバーを追加

リストにユーザーを追加

メンバーを削除

リストからユーザーを削除

メンバーシップ

ユーザーが所属しているリストを表示

エンドポイント

リストメンバーの取得

MethodEndpointDescription
GET/2/lists/:id/membersリストのメンバーを取得
GET/2/users/:id/list_membershipsユーザーが参加しているリストを取得

リストのメンバーを管理

MethodEndpointDescription
POST/2/lists/:id/membersメンバーを追加
DELETE/2/lists/:id/members/:user_idメンバーを削除

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

curl "https://api.x.com/2/lists/1234567890/members?\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

例:メンバーの追加

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

はじめに

前提条件

ルックアップ クイックスタート

リストメンバーの取得

管理クイックスタート

メンバーの追加・削除

インテグレーションガイド

重要な概念とベストプラクティス

APIリファレンス

エンドポイントの詳細ドキュメント