X Following List
Les abonnements d’un compte X sont des relations publiquement visibles qui indiquent quels profils un compte source suit, avec identité, biographies, liens, images, statut du compte, compteurs et détails de création. Ces enregistrements servent à étudier les réseaux d’intérêts, à découvrir des comptes, à cartographier des relations et à enrichir des jeux de données de profils.
Fonctionnalités de la X Following List API
- Collecte d’abonnements pour plusieurs comptesAcceptez un ou plusieurs noms d’utilisateur X publics et appliquez à chaque compte source une collecte d’abonnements bornée et distincte.
- Identité et contexte des profilsRenvoie les ID des comptes suivis, noms d’utilisateur, noms affichés, URL canoniques, biographies, sites web, localisations, avatars, bannières et dates de création des comptes.
- Signaux de compte et compteurs publicsAssocie les signaux visibles de vérification, de protection, de messagerie, de post épinglé et d’automatisation aux nombres d’abonnés, d’abonnements, de posts, de médias et de mentions « J’aime ».
- Enregistrements normalisés rattachés à leur sourceGarde chaque profil sauvegardé dans une structure publique homogène, avec collected_at et extra.input_username pour retrouver le compte source.
Paramètres de la X Following List API
| Paramètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Tableau obligatoire de noms d’utilisateur X publics non vides. Les valeurs peuvent comporter ou non un @ initial. |
results_limit | Facultatif | Nombre maximal de profils suivis demandés par nom d’utilisateur. Vaut 200 par défaut et accepte les multiples de 200 de 200 à 2 000. |
Comment utiliser la X Following List API
Envoyez des noms d’utilisateur sources publics, puis lisez les enregistrements normalisés des profils suivis à la fin de la tâche asynchrone.
- Préparez un ou plusieurs noms d’utilisateur X publics, avec ou sans @ initial, et choisissez un results_limit par nom d’utilisateur qui soit un multiple de 200 de 200 à 2 000.
- Envoyez usernames et results_limit en POST à /v1/x/following-list, puis conservez le task_id renvoyé.
- Interrogez GET /v1/tasks/{task_id} tant que la tâche est en queued, running ou retrying, et arrêtez-vous dès qu’elle réussit ou échoue.
- Après un succès, lisez data.results.items et continuez à interroger la tâche avec next_cursor tant que data.results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/following-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@X"],"results_limit":200}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass next_cursor while data.results.has_more is trueCas d’usage de la X Following List API
- Étude des réseaux d’intérêts : Reliez chaque nom d’utilisateur source conservé à l’identité, aux biographies, aux liens et aux localisations des profils suivis pour examiner les centres d’intérêt publics autour de comptes connus.
- Découverte de comptes à partir de profils de départ : Appuyez-vous sur les noms, biographies, images, signaux de vérification et compteurs visibles pour passer en revue les comptes candidats repérés dans la liste d’abonnements publique d’un profil source.
- Enrichissement de listes de relations : Ajoutez ID stables, URL de profil canoniques, métadonnées publiques de compte, compteurs et dates de collecte à vos enregistrements de relations fondés sur des noms d’utilisateur.
Conseils d’expert pour la X Following List API
- Retirez les @ initiaux et dédoublonnez les noms d’utilisateur sources sans tenir compte de la casse avant l’envoi, pour que des identifiants équivalents ne répètent pas le travail sur un même compte source.
- Dimensionnez results_limit par nom d’utilisateur, par pas de 200 ; avec plusieurs sources, prévoyez jusqu’à usernames × results_limit enregistrements avant la fin des listes et le dédoublonnage au niveau de la tâche.
- Pour construire un graphe plusieurs-à-plusieurs, ne supposez pas une ligne sauvegardée par couple profil source – profil suivi : un profil suivi qui se répète peut être dédoublonné et ne garder qu’une seule valeur extra.input_username.
- Voyez dans une liste vide ou courte un effet de la visibilité publique, et laissez les images, signaux de statut et compteurs facultatifs nullables dans vos enregistrements en aval.
- N’interprétez pas l’ordre renvoyé comme l’ancienneté d’une relation, l’intensité d’une interaction ou une recommandation : la réponse expose l’ordre de collecte, non ces signaux.
API associées
En complément de la X Following List API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques X.
- Twitter Profile Scraper API — Récupérez par nom d’utilisateur l’identité publique d’un compte, ses biographies, avatars, images de couverture, statut du compte et statistiques d’audience visibles.
- Twitter User Tweets Scraper API — Collectez par nom d’utilisateur les posts publics récents, auteurs, médias, hashtags, mentions et l’engagement, hors réponses.
- X Followers List API — Collectez les identités des abonnés publics et les indicateurs de profil visibles pour un ou plusieurs noms d’utilisateur X.
- X Post Retweeters API — Collectez, au niveau de la tâche, un ensemble unique de profils publics normalisés des comptes ayant reposté des URL de statuts X ou Twitter connues.
- X Community API — Lisez des liens de communautés pour obtenir descriptions, nombres de membres, règles et conditions d’adhésion.
- X Account Location API — Consultez le pays où un compte est basé, son mode de connexion à X, sa date d’inscription et ses changements de nom d’utilisateur.
- Twitter Tweet Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API