Ricerca dei membri della List

Nota: Questa guida presuppone che tu abbia completato i prerequisiti nella panoramica Avvio rapido.

​

Passaggi per creare una richiesta di ricerca dei membri di una List

Primo passaggio: scegli la raccolta di endpoint List in Postman

Una volta caricata la raccolta X API v2 in Postman, vai alla cartella “List”, seleziona l’altra cartella “List members” e quindi scegli “Members lookup”.  

Secondo passaggio: identifica e specifica da quale List desideri recuperare i membri

Devi specificare una List dalla quale desideri ottenere i membri. Puoi trovare l’ID della List navigando su x.com, facendo clic su una List e poi guardando l’URL. Ad esempio, l’ID della List del seguente URL è 84839422.

https://x.com/i/lists/84839422

L’ID di destinazione può essere qualsiasi ID di List valido. In Postman, vai alla scheda “Params” e inserisci il tuo ID nella colonna “Value” della variabile di percorso id. Assicurati di non includere spazi prima o dopo l’ID.

Key	Value
id	84839422 (List ID)

Terzo passaggio: identifica e specifica quali fields desideri recuperare

Se fai clic sul pulsante “Send” dopo il terzo passaggio, riceverai nella risposta i fields predefiniti dell’oggetto utente: id, name e username.

Se desideri ricevere fields aggiuntivi oltre a id, name e username, dovrai specificare tali fields nella richiesta con i parametri fields e/o expansions.

Per questo esercizio richiederemo tre insiemi aggiuntivi di fields da oggetti diversi:

• Il field aggiuntivo user.created_at negli oggetti utente principali.
• L’Oggetto Post completo utilizzando il parametro expansions.
• Il field aggiuntivo tweet.created_at negli oggetti Post associati.

In Postman, vai alla scheda “Params” e aggiungi la seguente coppia chiave:valore alla tabella “Query Params”:

Key	Value	Returned fields
user.fields	created_at	created_at
expansions	pinned_tweet_id	includes.tweets.id, <br/>includes.tweets.text <br/>
tweet.fields	created_at	includes.tweets.created_at

Ora dovresti vedere un URL simile accanto al pulsante “Send”:

https://api.x.com/2/lists/84839422/members?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at

Quarto passaggio: invia la richiesta e rivedi la risposta

Una volta configurato tutto, fai clic sul pulsante “Send” e riceverai una risposta simile al seguente esempio:

{
  "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": "Vuoi aiutare a costruire un nuovo approccio guidato dalla comunità per contrastare le informazioni fuorvianti? Unisciti a noi — registrati su Birdwatch! \n\nhttps://t.co/FSsqNznPy1"
      },
      {
        "created_at": "2021-10-21T17:29:07.000Z",
        "id": "1451239134798942208",
        "text": "è arrivato il momento -- ora stiamo distribuendo la possibilità per tutti su iOS e Android di ospitare uno Space\n\nse è la prima volta che ospiti, benvenuto! ecco un ripasso su come fare 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": "Eppure, Voliamo\n\n... perché non importa quante volte il 2020 ha cercato di abbatterci, ci siamo rialzati e abbiamo risposto con empatia, agilità, innovazione e leadership.\n\nLeggi di più nel nostro Report Annuale 2020 su Inclusione e Diversità #UntilWeAllBelong"
      }
    ]
  },
  "meta": {
    "result_count": 10,
    "next_token": "5349804505549807616"
  }
}