メインコンテンツへスキップ
ご注意: このガイドは、クイックスタート概要で示した前提条件を完了していることを想定しています。

​
List メンバー照会リクエストを作成する手順

ステップ1: Postman で List の endpoint コレクションを選択 Postman に X API v2 コレクションを読み込んだら、「List」フォルダーに移動し、サブフォルダー「List members」を選択してから「Members lookup」を選びます。   ステップ2: 取得したいメンバーが属する List を特定して指定 メンバーを取得したい対象の List を指定する必要があります。List の ID は x.com で任意の List をクリックし、URL を確認することで見つけられます。たとえば、次の URL の List ID は 84839422 です。 https://x.com/i/lists/84839422 対象 ID は有効な任意の List ID で構いません。Postman で「Params」タブに移動し、id パス変数の「Value」列に ID を入力します。ID の前後にスペースを含めないように注意してください。
KeyValue
id84839422（List ID）
ステップ3: 取得したい fields を特定して指定 ステップ3の後に「Send」ボタンをクリックすると、レスポンスには既定の ユーザーオブジェクト の fields が含まれます: id、name、username。 id、name、username 以外の追加の fields を受け取りたい場合は、fields および/または expansions パラメータでそれらの fields をリクエストに指定する必要があります。 この演習では、異なるオブジェクトから次の 3 つの追加の fields セットをリクエストします:
  • 主要なユーザーオブジェクトの追加の user.created_at field。
  • expansions パラメータを使用した完全な Post オブジェクト。
  • 関連する Post オブジェクトの追加の tweet.created_at field。
Postman で「Params」タブに移動し、「Query Params」テーブルに次の key:value の組み合わせを追加します:
KeyValueReturned fields
user.fieldscreated_atcreated_at
expansionspinned_tweet_idincludes.tweets.id, <br/>includes.tweets.text <br/>
tweet.fieldscreated_atincludes.tweets.created_at
これで「Send」ボタンの横に次のような URL が表示されるはずです: https://api.x.com/2/lists/84839422/members?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at ステップ4: リクエストを送信してレスポンスを確認 準備が整ったら「Send」ボタンを押すと、次の例のレスポンスに類似した結果を受け取れます。 
{
  "data": [
    {
      "pinned_tweet_id": "1353789891348475905",
      "id": "1319036828964454402",
      "created_at": "2020-10-21T22:04:47.000Z",
      "name": "Birdwatch",
      "username": "birdwatch"
    },
    {
      "id": "1244731491088809984",
      "created_at": "2020-03-30T21:02:29.000Z",
      "name": "Twitter Thailand",
      "username": "TwitterThailand"
    },
    {
      "id": "1194267639100723200",
      "created_at": "2019-11-12T14:56:22.000Z",
      "name": "Twitter Retweets",
      "username": "TwitterRetweets"
    },
    {
      "id": "1168976680867762177",
      "created_at": "2019-09-03T19:59:02.000Z",
      "name": "Twitter Able",
      "username": "TwitterAble"
    },
    {
      "pinned_tweet_id": "1451239134798942208",
      "id": "1065249714214457345",
      "created_at": "2018-11-21T14:24:58.000Z",
      "name": "Spaces",
      "username": "TwitterSpaces"
    },
    {
      "id": "1049385226424786944",
      "created_at": "2018-10-08T19:45:09.000Z",
      "name": "Twitter Miami",
      "username": "TwitterMiami"
    },
    {
      "pinned_tweet_id": "1438533888498876420",
      "id": "1004367799588880384",
      "created_at": "2018-06-06T14:21:58.000Z",
      "name": "Twitter México",
      "username": "TwitterMexico"
    },
    {
      "pinned_tweet_id": "1370178223846297602",
      "id": "773578328498372608",
      "created_at": "2016-09-07T17:47:00.000Z",
      "name": "Twitter Together",
      "username": "TwitterTogether"
    },
    {
      "id": "766296039036948480",
      "created_at": "2016-08-18T15:29:47.000Z",
      "name": "Moments MENA",
      "username": "momentsmena"
    },
    {
      "id": "738118487122419712",
      "created_at": "2016-06-01T21:22:15.000Z",
      "name": "Twitter Asians",
      "username": "TwitterAsians"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-01-25T19:40:36.000Z",
        "id": "1353789891348475905",
        "text": "誤解を招く情報への対処に向けた新しいコミュニティ主導のアプローチの構築にご協力いただけませんか？ぜひご参加ください — Birdwatchにサインアップしましょう！\n\nhttps://t.co/FSsqNznPy1"
      },
      {
        "created_at": "2021-10-21T17:29:07.000Z",
        "id": "1451239134798942208",
        "text": "ついにその時が来ました -- iOSとAndroidのすべてのユーザーがSpacesをホストできる機能を展開中です\n\n初めてホストされる方は、ようこそ！使い方のおさらいはこちらです https://t.co/cLH8z0bocy"
      },
      {
        "created_at": "2021-09-16T16:03:00.000Z",
        "id": "1438533888498876420",
        "text": "Algunos le dicen amor, pero yo le digo:\n\n‌    ∧＿∧　 \n（｡･ω･｡)つ━☆・*\n⊂     　ノ 　　　・゜+.\n　しーＪ　　　°。+ *´¨)\n　　　　　 　　　☆ RECALENTADO ☆ \n#VivaMéxico"
      },
      {
        "created_at": "2021-03-12T01:01:59.000Z",
        "id": "1370178223846297602",
        "text": "それでも、私たちは飛び続ける\n\n... 2020年が何度私たちを打ち倒そうとしても、私たちは立ち上がり、共感、俊敏性、革新、そしてリーダーシップで応えたからです。\n\n2020年インクルージョン＆ダイバーシティ年次報告書で詳細をご覧ください #UntilWeAllBelong"
      }
    ]
  },
  "meta": {
    "result_count": 10,
    "next_token": "5349804505549807616"
  }
}
⌘I