Consulta de membros da List

Este guia mostra como recuperar os membros de uma List.

Pré-requisitosAntes de começar, você precisará de:

Uma conta de desenvolvedor com um App aprovado
O Bearer Token do seu App

Obter membros da List

Encontre o ID da List

Você pode encontrar o ID da List na URL ao visualizar uma List:

https://x.com/i/lists/84839422
                      └── Este é o ID da List

Solicite os membros da List

cURL

curl "https://api.x.com/2/lists/84839422/members?\
user.fields=created_at,username,verified&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter membros da List com paginação
for page in client.lists.get_members(
    "84839422",
    user_fields=["created_at", "username", "verified"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Joined: {user.created_at}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obter membros da List com paginação
const paginator = client.lists.getMembers("84839422", {
  userFields: ["created_at", "username", "verified"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(`${user.username} - Joined: ${user.created_at}`);
  });
}

Revise a resposta

{
  "data": [
    {
      "id": "1319036828964454402",
      "name": "Birdwatch",
      "username": "birdwatch",
      "created_at": "2020-10-21T22:04:47.000Z",
      "verified": true
    },
    {
      "id": "1065249714214457345",
      "name": "Spaces",
      "username": "TwitterSpaces",
      "created_at": "2018-11-21T14:24:58.000Z",
      "verified": true
    }
  ],
  "meta": {
    "result_count": 2,
    "next_token": "5349804505549807616"
  }
}

Incluir dados adicionais

Use expansions para obter dados relacionados, como Posts fixados:

cURL

curl "https://api.x.com/2/lists/84839422/members?\
user.fields=created_at&\
expansions=pinned_tweet_id&\
tweet.fields=created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obter membros da List com expansions
for page in client.lists.get_members(
    "84839422",
    user_fields=["created_at"],
    expansions=["pinned_tweet_id"],
    tweet_fields=["created_at"]
):
    for user in page.data:
        print(f"{user.username}")
    # Posts fixados estão em page.includes.tweets

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obter membros da List com expansions
const paginator = client.lists.getMembers("84839422", {
  userFields: ["created_at"],
  expansions: ["pinned_tweet_id"],
  tweetFields: ["created_at"],
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(user.username);
  });
  // Posts fixados estão em page.includes?.tweets
}

Próximos passos

Gerenciar membros da List

Adicione e remova membros

Consulta de List

Obtenha detalhes da List

Referência da API

Documentação completa do endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Consulta de membros da List

Obter membros da List

Incluir dados adicionais

Próximos passos

Gerenciar membros da List

Consulta de List

Referência da API

​Obter membros da List

​Incluir dados adicionais

​Próximos passos

Gerenciar membros da List

Consulta de List

Referência da API

Obter membros da List

Incluir dados adicionais

Próximos passos