Pular para o conteúdo principal
Atenção: Este guia pressupõe que você já concluiu os pré-requisitos da visão geral de Introdução rápida.

​
Etapas para criar uma solicitação de busca de membros de uma List

Etapa um: Escolha a coleção de endpoints de List no Postman Depois de carregar a coleção da X API v2 no Postman, navegue até a pasta “List”, selecione a pasta “List members” e, em seguida, escolha “Members lookup”. Etapa dois: Identifique e especifique de qual List você deseja recuperar membros Você deve especificar uma List da qual deseja receber membros. Você pode encontrar o ID da List acessando x.com, clicando em uma List e, então, observando a URL. Por exemplo, o ID da List na seguinte URL é 84839422. https://x.com/i/lists/84839422 O ID de destino pode ser qualquer ID de List válido. No Postman, navegue até a aba “Params” e insira seu ID na coluna “Value” da variável de caminho id. Certifique-se de não incluir espaços antes ou depois de qualquer ID.
KeyValue
id84839422 (List ID)
Etapa três: Identifique e especifique quais fields você deseja recuperar Se você clicar no botão “Send” após a etapa três, receberá, na sua resposta, os fields padrão do objeto de usuário: id, name e username. Se quiser receber fields adicionais além de id, name e username, será necessário especificá-los na sua solicitação com os parâmetros fields e/ou expansions. Para este exercício, solicitaremos três conjuntos adicionais de fields de diferentes objetos:
  • O field adicional user.created_at nos objetos de usuário primários.
  • O Objeto Post completo usando o parâmetro expansions.
  • O field adicional tweet.created_at nos objetos Post associados.
No Postman, navegue até a aba “Params” e adicione o seguinte par key:value à tabela “Query Params”:
KeyValueReturned fields
user.fieldscreated_atcreated_at
expansionspinned_tweet_idincludes.tweets.id, <br/>includes.tweets.text <br/>
tweet.fieldscreated_atincludes.tweets.created_at
Agora você deverá ver uma URL semelhante próxima ao botão “Send”: https://api.x.com/2/lists/84839422/members?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at Etapa quatro: Faça sua solicitação e revise sua resposta Depois que tudo estiver configurado, clique no botão “Send” e você receberá uma resposta semelhante ao exemplo a seguir: 
{
  "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": "Quer ajudar a construir uma nova abordagem orientada pela comunidade para combater informações enganosas? Junte-se a nós — cadastre-se no Birdwatch! \n\nhttps://t.co/FSsqNznPy1"
      },
      {
        "created_at": "2021-10-21T17:29:07.000Z",
      "id": "1451239134798942208",
        "text": "chegou a hora -- agora estamos liberando a funcionalidade para todos no iOS e Android criarem um Space\n\nse esta é sua primeira vez criando, bem-vindo! aqui está um resumo sobre como 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": "Ainda Assim, Voamos\n\n... porque não importa quantas vezes 2020 tentou nos derrubar, nos levantamos e respondemos com empatia, agilidade, inovação e liderança.\n\nLeia mais em nosso Relatório Anual de Inclusão &amp; Diversidade 2020 #UntilWeAllBelong"
      }
    ]
  },
  "meta": {
    "result_count": 10,
    "next_token": "5349804505549807616"
  }
}
⌘I