Introduction

Nous proposons deux groupes d’endpoints pour vous aider à consulter, créer et supprimer des relations d’abonnement : follows lookup et manage follows.

​

Recherche des abonnements

Disponible uniquement pour les personnes disposant de l’accès Enterprise

Les endpoints de recherche des abonnements vous permettent d’explorer et d’analyser les relations entre utilisateurs, parfois appelées analyse de réseau. Plus précisément, deux endpoints REST renvoient des objets utilisateur représentant les comptes qu’un utilisateur spécifié suit, ou les comptes qui suivent un utilisateur spécifié.

Vous pouvez authentifier cet endpoint avec Contexte utilisateur OAuth 1.0a, [App only](https://developer.x.com(/resources/fundamentals/authentication#app-only-authentication-and-oauth-2-0-bearer-token), ou OAuth 2.0 Autorisation par code avec PKCE. Vous pouvez demander jusqu’à 1 000 utilisateurs par requête, et des jetons de pagination seront fournis pour parcourir de grands ensembles de résultats.  

​

Gérer les abonnements

Les endpoints de gestion des abonnements vous permettent de vous abonner à des utilisateurs ou de vous en désabonner.

Comme vous effectuez des requêtes au nom d’un utilisateur, vous devez authentifier ces endpoints avec le Contexte utilisateur OAuth 1.0a ou l’OAuth 2.0 Autorisation par code avec PKCE, et utiliser les Access Tokens de l’utilisateur au nom duquel vous envoyez la requête. Vous pouvez générer cet Access Token utilisateur à l’aide du flux OAuth à 3 étapes (OAuth 1.0a) ou du flux Autorisation par code avec PKCE (OAuth 2.0).

Vous êtes limité à 400 actions d’abonnement par jour et par utilisateur authentifié, et à 1 000 actions par jour et par App pour l’ensemble de vos utilisateurs authentifiés. Par exemple, si vous avez cinq utilisateurs authentifiés, vous pouvez vous abonner à 400 utilisateurs par jour (limite par utilisateur) avec deux de ces utilisateurs pour un total de 800 actions, et devrez répartir les 200 actions restantes (limite par App) entre les trois autres utilisateurs. Cette limite ne s’applique pas à l’endpoint de désabonnement, qui a une limite distincte de 500 actions par jour (par App).

Configuration du compte

Pour accéder à ces endpoints, vous aurez besoin de :

• D’un compte développeur approuvé.
• D’authentifier en utilisant les clés et jetons d’une App développeur située au sein d’un Project.

Pour en savoir plus sur l’accès aux endpoints X API v2, consultez notre guide de démarrage.

Bien démarrer

Exemples de code

Exécuter dans Postman

Essayer avec API Explorer