Démarrage rapide

Récupérez les listes d’abonnés et d’abonnements et gérez les abonnements

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

Prérequis

Avant 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

shellscript

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

​

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

shellscript

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

---

​

Suivre un utilisateur

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

cURL

shellscript

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

​

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

shellscript

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

​

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