Passer au contenu principal
Remarque : Ce guide suppose que vous avez satisfait aux prérequis indiqués dans la vue d’ensemble Bien démarrer.

​
Étapes pour créer une requête de recherche des membres d’une List

Première étape : Choisir la collection d’endpoint List dans Postman Une fois la collection X API v2 chargée dans Postman, accédez au dossier « List », sélectionnez le dossier « List members », puis choisissez « Members lookup ».   Deuxième étape : Identifier et préciser la List dont vous souhaitez récupérer les membres Vous devez indiquer la List dont vous souhaitez obtenir les membres. Vous pouvez trouver l’ID de la List en vous rendant sur x.com, en cliquant sur une List, puis en regardant l’URL. Par exemple, l’ID de la List de l’URL suivante est 84839422. https://x.com/i/lists/84839422 L’ID cible peut être n’importe quel ID de List valide. Dans Postman, accédez à l’onglet « Params » et saisissez votre ID dans la colonne « Value » de la variable de chemin id. Veillez à ne pas inclure d’espaces avant ou après un ID.
KeyValue
id84839422 (List ID)
Troisième étape : Identifier et spécifier les fields que vous souhaitez récupérer Si vous cliquez sur le bouton « Send » après la troisième étape, vous recevrez, dans votre réponse, les fields par défaut de l’objet utilisateur : id, name et username. Si vous souhaitez recevoir des fields supplémentaires au‑delà de id, name et username, vous devrez les spécifier dans votre requête à l’aide des paramètres fields et/ou expansions. Pour cet exercice, nous demanderons trois ensembles supplémentaires de fields provenant d’objets différents :
  • Le field supplémentaire user.created_at dans les objets utilisateur principaux.
  • L’Objet Post complet à l’aide du paramètre expansion.
  • Le field supplémentaire tweet.created_at dans les objets Post associés.
Dans Postman, accédez à l’onglet « Params » et ajoutez la paire clé:valeur suivante au tableau « Query Params » :
KeyValueReturned fields
user.fieldscreated_atcreated_at
expansionspinned_tweet_idincludes.tweets.id, <br/>includes.tweets.text <br/>
tweet.fieldscreated_atincludes.tweets.created_at
Vous devriez maintenant voir une URL similaire à côté du bouton « Send » : https://api.x.com/2/lists/84839422/members?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at Quatrième étape : Envoyer votre requête et examiner la réponse Une fois que tout est prêt, cliquez sur le bouton « Send » ; vous recevrez une réponse similaire à l’exemple suivant : 
{
  "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": "Vous souhaitez contribuer à une nouvelle approche communautaire pour lutter contre la désinformation ? Rejoignez-nous — inscrivez-vous à Birdwatch ! \n\nhttps://t.co/FSsqNznPy1"
      },
      {
        "created_at": "2021-10-21T17:29:07.000Z",
        "id": "1451239134798942208",
        "text": "le moment est arrivé -- nous déployons désormais la possibilité pour tous sur iOS et Android d'animer un Space\n\nsi c'est votre première fois en tant qu'animateur, bienvenue ! voici un rappel sur la marche à suivre 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": "Malgré tout, nous volons\n\n... car peu importe le nombre de fois où 2020 a tenté de nous faire tomber, nous nous sommes relevés et avons réagi avec empathie, agilité, innovation et leadership.\n\nPour en savoir plus, consultez notre Rapport annuel 2020 sur l'inclusion et la diversité #UntilWeAllBelong"
      }
    ]
  },
  "meta": {
    "result_count": 10,
    "next_token": "5349804505549807616"
  }
}
⌘I