x/
check-follow

Vérifiez si un compte X suit jusqu’à 100 autres comptes et si chacun d’eux le suit en retour, avec is_following, is_followed_by et is_mutual pour chaque paire de noms d’utilisateur.

Twitter Follow Checker API

Les deux sens d’abonnement
Jusqu’à 100 paires par tâche
Indicateur d’abonnement mutuel
0,7 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

Twitter Follow Checker

Sur X, anciennement Twitter, un abonnement est un lien à sens unique d’un compte vers un autre, si bien que deux comptes se trouvent toujours dans l’un de ces quatre états : aucun ne suit l’autre, le premier suit le second, le second suit le premier, ou chacun suit l’autre. Savoir dans quel état se trouve une paire répond à des questions courantes, par exemple si les participants d’un concours suivent une marque, si un partenaire s’est abonné en retour ou à quel point un groupe de créateurs est interconnecté.

Fonctionnalités de la Twitter Follow Checker API

  • Un compte face à jusqu’à 100 autresPlacez le compte à vérifier dans username et jusqu’à 100 comptes dans usernames : chaque paire revient sur sa propre ligne avec source_username et target_username.
  • Les deux sens et le résultat mutuel sur une seule ligneis_following indique si username suit l’autre compte, is_followed_by indique si ce compte le suit en retour, et is_mutual vaut true lorsque les deux sont vrais.
  • Clé de paire et lien de profilid prend la forme source_username:target_username et url pointe vers le profil de la cible : les lignes se joignent proprement à vos propres listes et s’ouvrent en un clic.

Paramètres de la Twitter Follow Checker API

ParamètresObligatoireDescription
usernameObligatoireCompte X à vérifier, comparé à chacun des comptes de usernames.
usernamesObligatoireJusqu’à 100 noms d’utilisateur X à comparer à username. Chacun renvoie une ligne pour sa paire.

Comment utiliser la Twitter Follow Checker API

Envoyez un compte et les comptes auxquels le comparer, puis lisez une ligne par paire.

  1. Envoyez {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]} en POST à /v1/x/check-follow.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez chaque paire dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"elonmusk","usernames":["SpaceX","NASA"]}'

# is_following: elonmusk follows the target; is_followed_by: the target follows elonmusk back.

Cas d’usage de la Twitter Follow Checker API

  • Contrôler la condition d’abonnement des participants à un concours : Placez le compte de la marque dans username et jusqu’à 100 participants dans usernames, puis gardez les participants dont is_followed_by vaut true.
  • Repérer les partenaires qui ne vous suivent pas encore en retour : Comparez votre compte aux créateurs ou aux marques que vous suivez et listez les paires où is_following vaut true et is_followed_by vaut false.
  • Cartographier les liens au sein d’un groupe de créateurs : Passez chaque membre dans username face au reste du groupe et utilisez is_mutual pour représenter qui est connecté à qui.
  • Surveiller quelles marques concurrentes suit un compte clé : Comparez le compte d’un dirigeant ou d’un journaliste à une liste de concurrents, puis relancez la vérification plus tard pour voir quand is_following change.

Conseils d’expert pour la Twitter Follow Checker API

  • Pour les listes de plus de 100 comptes, supprimez les doublons, découpez-les en lots de 100 et fusionnez les résultats par id.
  • Notez comme non vérifiée une cible pour laquelle aucune ligne n’est renvoyée, et gardez-la à part des paires signalées à false ; seuls les comptes trouvés produisent une ligne.
  • Stockez collected_at avec chaque paire et relancez la même vérification plus tard ; la comparaison des collectes fait apparaître les nouveaux abonnements et les désabonnements.

En complément de la Twitter Follow Checker 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.
  • 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 Following List API — Collectez les profils suivis par des comptes X publics, avec identité, biographies, signaux de compte, compteurs visibles et noms d’utilisateur sources.
  • 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.

Twitter Follow Checker API — FAQ

Twitter Follow Checker API est une interface programmatique qui vérifie les relations d’abonnement entre un compte X et jusqu’à 100 autres, à partir de leurs seuls noms d’utilisateur. Chaque paire indique si le premier compte suit le second, s’il est suivi en retour et si l’abonnement est mutuel.

Placez le premier compte dans username et le second dans usernames. is_following indique si le premier suit le second, et is_followed_by répond à la question inverse sur la même ligne.

Placez votre propre identifiant dans username et le sien dans usernames. is_followed_by à true signifie que cette personne vous suit, et une tâche peut couvrir jusqu’à 100 comptes.

Lisez is_mutual. Ce champ vaut true uniquement lorsque chaque compte suit l’autre.

Un compte dans username face à jusqu’à 100 comptes dans usernames, avec une ligne par paire. Répartissez les listes plus longues sur plusieurs tâches.

Les vérifications portent sur des comptes publics, par nom d’utilisateur. Les comptes protégés gardent leurs listes d’abonnements masquées sur X : les paires qui les concernent ne peuvent donc pas être confirmées.

Pas avec cet endpoint, qui ne renvoie que les paires que vous envoyez. Utilisez X Following List API ou X Followers List API pour obtenir les listes complètes.