Recherche des membres d’une Liste

Ce guide vous explique comment récupérer les membres d’une Liste.

PrérequisAvant de commencer, vous aurez besoin :

D’un compte développeur disposant d’une App approuvée
Du Jeton Bearer associé à votre App

Obtenir les membres d’une Liste

Trouver l’ID de la Liste

Vous pouvez trouver l’ID de la Liste dans l’URL lorsque vous consultez une Liste :

https://x.com/i/lists/84839422
                      └── Il s’agit de l’ID de la Liste

Récupérer les membres de la Liste

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")

# Récupérer les membres de la Liste avec pagination
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} - Inscription : {user.created_at}")

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

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

// Récupérer les membres de la Liste avec pagination
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} - Inscription : ${user.created_at}`);
  });
}

Examiner la réponse

{
  "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"
  }
}

Inclure des données supplémentaires

Utilisez le paramètre expansions pour obtenir des données associées, comme les Publications épinglées :

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")

# Récupérer les membres de la Liste avec 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}")
    # Les Publications épinglées se trouvent dans page.includes.tweets

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

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

// Récupérer les membres de la Liste avec 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);
  });
  // Les Publications épinglées se trouvent dans page.includes?.tweets
}

Prochaines étapes

Gérer les membres de la liste

Ajouter et supprimer des membres

Recherche de liste

Obtenir les détails de la liste

Référence de l’API

Documentation complète de l’endpoint

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Recherche des membres d’une Liste

Obtenir les membres d’une Liste

Inclure des données supplémentaires

Prochaines étapes

Gérer les membres de la liste

Recherche de liste

Référence de l’API