メインコンテンツへスキップ

リストメンバーのルックアップ

メンバーのルックアップには 2 つのエンドポイントがあります。指定したリストのメンバーの詳細を取得したり、特定のユーザーがどのリストのメンバーかを確認できます。これらのエンドポイントを使うことで、メンバー情報に基づいて新しいリストを作成・整理できます。 メンバーの詳細を取得する場合は 15 分あたり 900 リクエスト、ユーザーのメンバーシップを取得する場合は 15 分あたり 75 リクエストのレート制限があります。 このエンドポイントへのリクエストの認証には、OAuth 1.0a ユーザーコンテキストApp only、または OAuth 2.0 認可コード(PKCE 対応) を使用できます。   

リストメンバーの管理

リストメンバー管理エンドポイントを使用すると、認証済みユーザーに代わってリストのメンバーを追加・削除できます。これらのエンドポイントには POST と DELETE の 2 つのメソッドがあります。POST はリストへのメンバー追加、DELETE はリストからのメンバー削除を行います。両エンドポイントとも、ユーザーあたり 15 分間に 300 リクエストのレート制限があります。 1 つのリストに含められるメンバーは最大 5,000 人です。 これらのエンドポイントではユーザーに代わってリクエストを行うため、OAuth 1.0a ユーザーコンテキスト または OAuth 2.0 認可コード(PKCE 対応) のいずれかで認証し、あなたのアプリを承認したユーザーに関連付けられたユーザーアクセストークンを使用する必要があります。これらは 3-legged OAuth フロー(OAuth 1.0a)または Authorization Code with PKCE grant フロー(OAuth 2.0)で生成できます。
アカウントのセットアップこれらのエンドポイントにアクセスするには、次が必要です。Learn more about getting access to the X API v2 endpoints in our getting started guide.