Recherche de comptes masqués

Ce guide vous explique comment récupérer la liste de vos utilisateurs masqués à l’aide de l’X API.

PrérequisAvant de commencer, vous aurez besoin de :

d’un compte développeur avec une App approuvée
d’un jeton d’accès utilisateur (OAuth 1.0a ou OAuth 2.0 PKCE)

Récupérer vos comptes masqués

Obtenir votre ID d’utilisateur

Vous avez besoin de l’ID de l’utilisateur authentifié. Vous pouvez le trouver en utilisant l’endpoint de recherche d’utilisateurs ou dans votre jeton d’accès (la partie numérique correspond à votre ID d’utilisateur).

Récupérer vos comptes masqués

cURL

curl "https://api.x.com/2/users/123456789/muting?\
user.fields=created_at,username,verified&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Récupérer les comptes masqués avec pagination
for page in client.users.get_muting(
    "123456789",
    user_fields=["created_at", "username", "verified"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Masqué")

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Récupérer les comptes masqués avec pagination
const paginator = client.users.getMuting("123456789", {
  userFields: ["created_at", "username", "verified"],
  maxResults: 100,
});

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

Examiner la réponse

{
  "data": [
    {
      "id": "2244994945",
      "name": "X Developers",
      "username": "XDevelopers",
      "created_at": "2013-12-14T04:35:55.000Z",
      "verified": true
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "1710819323648428707"
  }
}

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/users/123456789/muting?\
user.fields=created_at&\
expansions=pinned_tweet_id&\
tweet.fields=created_at" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Récupérer les utilisateurs mis en sourdine avec le paramètre expansions
for page in client.users.get_muting(
    "123456789",
    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({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Récupérer les utilisateurs mis en sourdine avec le paramètre expansions
const paginator = client.users.getMuting("123456789", {
  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
}

Réponse avec expansion

{
  "data": [
    {
      "username": "XDevelopers",
      "created_at": "2013-12-14T04:35:55.000Z",
      "id": "2244994945",
      "name": "X Developers",
      "pinned_tweet_id": "1430984356139470849"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-08-26T20:03:51.000Z",
        "id": "1430984356139470849",
        "text": "Help us build a better X Developer Platform!..."
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}

Paginer les résultats

Les SDK gèrent automatiquement la pagination. Pour cURL, utilisez le next_token de la réponse :

curl "https://api.x.com/2/users/123456789/muting?\
max_results=100&\
pagination_token=1710819323648428707" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

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 de comptes masqués

Récupérer vos comptes masqués

Inclure des données supplémentaires

Réponse avec expansion

Paginer les résultats

Prochaines étapes

Gérer les mises en sourdine

Référence de l’API