Démarrage rapide

Ce guide vous explique comment récupérer les listes d’abonnés et d’abonnements, et gérer les abonnements.

PrérequisAvant de commencer, vous aurez besoin :

D’un compte développeur avec une App approuvée
Du jeton Bearer de votre App (pour les consultations)
D’un jeton d’accès utilisateur (User Access Token) pour gérer les abonnements

Obtenir les abonnés d’un utilisateur

Récupérez la liste des utilisateurs qui suivent un utilisateur donné :

cURL

curl "https://api.x.com/2/users/2244994945/followers?\
user.fields=username,verified,public_metrics&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtenir les abonnés d’un utilisateur avec pagination
for page in client.users.get_followers(
    "2244994945",
    user_fields=["username", "verified", "public_metrics"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Followers: {user.public_metrics.followers_count}")

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

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

// Obtenir les abonnés d’un utilisateur avec pagination
const paginator = client.users.getFollowers("2244994945", {
  userFields: ["username", "verified", "public_metrics"],
  maxResults: 100,
});

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

Réponse

{
  "data": [
    {
      "id": "1234567890",
      "name": "Developer",
      "username": "dev_user",
      "verified": false,
      "public_metrics": {
        "followers_count": 500,
        "following_count": 200,
        "tweet_count": 1500
      }
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "abc123"
  }
}

Obtenir la liste des comptes suivis par un utilisateur

Récupérez la liste des comptes suivis par un utilisateur donné :

cURL

curl "https://api.x.com/2/users/2244994945/following?\
user.fields=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 comptes suivis par un utilisateur
for page in client.users.get_following(
    "2244994945",
    user_fields=["username", "verified"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Verified: {user.verified}")

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

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

// Récupérer les comptes suivis par un utilisateur
const paginator = client.users.getFollowing("2244994945", {
  userFields: ["username", "verified"],
  maxResults: 100,
});

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

Suivre un utilisateur

Suivez un utilisateur pour le compte de l’utilisateur authentifié :

cURL

curl -X POST "https://api.x.com/2/users/123456789/following" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Suivre un utilisateur
response = client.users.follow(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Abonnement : {response.data.following}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Suivre un utilisateur
const response = await client.users.follow("123456789", {
  targetUserId: "2244994945",
});
console.log(`Abonnement : ${response.data?.following}`);

Réponse

{
  "data": {
    "following": true,
    "pending_follow": false
  }
}

Si le compte cible est protégé, pending_follow aura la valeur true tant que la demande d’abonnement n’aura pas été approuvée.

Ne plus suivre un utilisateur

Ne plus suivre un utilisateur pour le compte de l’utilisateur authentifié :

cURL

curl -X DELETE "https://api.x.com/2/users/123456789/following/2244994945" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Ne plus suivre un utilisateur
response = client.users.unfollow(
    source_user_id="123456789",
    target_user_id="2244994945"
)
print(f"Following: {response.data.following}")

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

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Ne plus suivre un utilisateur
const response = await client.users.unfollow("123456789", "2244994945");
console.log(`Following: ${response.data?.following}`);

Réponse

{
  "data": {
    "following": false
  }
}

Paramètres courants

Paramètre	Description
`max_results`	Nombre de résultats par page (1-1000, valeur par défaut : 100)
`pagination_token`	Jeton de pagination pour la page suivante
`user.fields`	Champs utilisateur supplémentaires
`expansions`	Objets connexes à inclure

Prochaines étapes

Recherche d’utilisateurs

Rechercher des profils d’utilisateurs

Blocages

Bloquer et débloquer des utilisateurs

Mises en sourdine

Mettre des utilisateurs en sourdine et réactiver le son

Référence de l’API

Documentation complète du point de terminaison

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

Démarrage rapide

Obtenir les abonnés d’un utilisateur

Réponse

Obtenir la liste des comptes suivis par un utilisateur

Suivre un utilisateur

Réponse

Ne plus suivre un utilisateur

Réponse

Paramètres courants

Prochaines étapes

Recherche d’utilisateurs

Blocages

Mises en sourdine

Référence de l’API