x/
following-list

Collectez les profils X publics suivis par un ou plusieurs noms d’utilisateur et obtenez identité, biographies, signaux de compte, compteurs visibles et contexte du compte source.

X Following List API

Relations d’abonnement
Contexte des profils
Limites par compte
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
usernamesObligatoireTableau obligatoire de noms d’utilisateur X publics non vides. Les valeurs peuvent comporter ou non un @ initial.
results_limitFacultatifNombre 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.

  1. 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.
  2. Envoyez usernames et results_limit en POST à /v1/x/following-list, puis conservez le task_id renvoyé.
  3. 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.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données X avec les données publiques d’autres plateformes sociales prises en charge.

X Following List API — FAQ

X Following List API est une interface programmatique qui collecte les profils publics suivis par un ou plusieurs noms d’utilisateur X. Elle renvoie identité, biographies, liens, visuels, signaux de compte, compteurs visibles, horodatages et contexte source sous forme normalisée.

Transmettez un tableau usernames non vide. Chaque identifiant public peut comporter ou non un @ initial, et les noms d’utilisateur sources équivalents sont normalisés sans tenir compte de la casse avant la collecte auprès du fournisseur.

results_limit vaut 200 par défaut, accepte les multiples de 200 jusqu’à 2 000 et s’applique séparément à chaque nom d’utilisateur source. Une liste visible peut se terminer avant la limite demandée.

Un enregistrement peut contenir l’ID du profil, le nom d’utilisateur, le nom affiché, l’URL canonique, la biographie, le site web, la localisation, l’avatar, la bannière, les signaux de vérification et de protection, les compteurs publics, la date de création du compte, l’heure de collecte et extra.input_username.

Pas nécessairement. Les identités de profil stables sont dédoublonnées à la sauvegarde : un profil suivi par plusieurs comptes envoyés peut n’apparaître qu’une fois, le contexte source étant conservé sur cet enregistrement sauvegardé.

Des comptes protégés ou restreints, des limites de visibilité publique, des pages de liste indisponibles ou la fin de la liste d’abonnements visible peuvent réduire les enregistrements sauvegardés. Vérifiez l’accessibilité publique du compte source avant de réessayer.

Non. Considérez l’ordre uniquement comme un ordre de collecte ; il n’établit ni le début d’une relation, ni la fréquence des interactions entre comptes, ni le fait que la source recommande un profil suivi.

Chaque profil normalisé sauvegardé coûte 0,5 crédit. La facturation repose sur le nombre réel d’enregistrements sauvegardés : un résultat vide n’entraîne donc aucun frais par unité de résultat.