x/
community-members

Exportez les membres d’une communauté X publique à partir de son lien, avec la bio, la localisation, le site web, l’indicateur de vérification et les compteurs d’abonnés de chaque membre, jusqu’à 2 000 par communauté.

X Community Members API

Lien de communauté en entrée
Un profil par membre
Jusqu’à 2 000 membres par communauté
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

X Community Members

Les membres d’une communauté X sont les comptes qui ont choisi de rejoindre une communauté thématique, et chacun dispose d’un profil public avec bio, localisation, site web, statut de vérification, date de création du compte et nombres d’abonnés, d’abonnements et de posts. Rejoindre une communauté étant une démarche volontaire autour d’un seul sujet, ces profils décrivent une audience qui s’est sélectionnée elle-même et que l’on peut mesurer, segmenter par portée ou par lieu, et comparer aux membres d’une communauté voisine.

Fonctionnalités de la X Community Members API

  • Listes de membres à partir de liens de communautésCollez un ou plusieurs liens https://x.com/i/communities/<id> : chaque membre de chaque communauté revient sous forme de ligne de profil distincte.
  • Qui est chaque membreLes lignes contiennent le nom d’utilisateur, le nom affiché, la bio dans text, l’avatar, l’image de couverture, le site web et la localisation indiquée, de sorte qu’un membre peut être identifié et décrit à partir de l’export seul.
  • La portée de chaque membremetrics contient followers_count, following_count et posts_count, ce qui distingue les voix influentes d’une communauté de sa majorité silencieuse.
  • Vérification et ancienneté du compteis_verified, is_private et published_at, la date de création du compte X du membre, montrent d’un coup d’œil à quel point chaque personne de la liste est établie.

Paramètres de la X Community Members API

ParamètresObligatoireDescription
urlsObligatoireLiens de communautés X publiques au format https://x.com/i/communities/<numeric_id>, un par ligne.
results_limitFacultatifNombre de membres à renvoyer pour chaque communauté, multiple de 20 compris entre 20 et 2 000. 100 par défaut.

Comment utiliser la X Community Members API

Envoyez des liens de communautés et parcourez les profils des membres page par page.

  1. Envoyez {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} en POST à /v1/x/community-members.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les profils des membres dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":100}'

# results_limit is applied to each community in urls, so two links can return up to 200 members here.

Cas d’usage de la X Community Members API

  • Dresser le profil de l’audience d’une communauté : Regroupez les membres par location.name, parcourez les bios dans text pour repérer fonctions et centres d’intérêt, et représentez followers_count pour décrire qui a réellement rejoint une communauté.
  • Présélectionner des membres pour des partenariats : Triez les membres par metrics.followers_count, gardez les comptes vérifiés et appuyez-vous sur website et la bio pour choisir les créateurs à contacter au sein d’une niche.
  • Mesurer le recoupement entre deux communautés : Exportez les membres de deux communautés proches et rapprochez-les par id pour compter les personnes qui appartiennent aux deux.
  • Repérer les comptes récents dans une communauté : Croisez un published_at récent avec de faibles posts_count et followers_count pour voir quelle part des membres d’une communauté sont des comptes nouvellement créés ou presque inactifs.

Conseils d’expert pour la X Community Members API

  • Envoyez une seule communauté par tâche si vous comptez comparer des listes de membres ; les lignes de membres ne contiennent que le profil, c’est donc l’entrée de la tâche qui rattache chaque ligne à sa communauté.
  • Lisez d’abord members_count avec X Community ou X Communities Search, puis réglez results_limit sur le multiple de 20 immédiatement supérieur pour demander la liste complète en une tâche.
  • Normalisez location.name avant de regrouper par pays : ce champ contient le lieu saisi librement par le membre, comme « Sydney », et les champs de ville et de pays sont souvent vides.

En complément de la X Community Members 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 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.
  • X Community Moderators API — Récupérez les administrateurs et modérateurs d’une communauté sous forme de profils complets.

Explorer d’autres plateformes

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

X Community Members API — FAQ

X Community Members API est une interface programmatique qui exporte les membres de communautés X publiques à partir de leurs liens /i/communities/. Elle renvoie un profil par membre avec nom d’utilisateur, bio, localisation, site web, statut de vérification et nombres d’abonnés, d’abonnements et de posts.

Oui. Le lien de la communauté est la seule entrée : vous pouvez exporter les membres d’une communauté publique que vous n’avez jamais rejointe, sans aucune connexion à X.

Recherchez un mot-clé avec X Communities Search. Chaque résultat inclut l’url de la communauté, que vous pouvez transmettre telle quelle à cet endpoint.

Jusqu’à 2 000. results_limit accepte les multiples de 20 de 20 à 2 000, vaut 100 par défaut et s’applique séparément à chaque lien de communauté de la requête.

Non. published_at est la date de création du compte X du membre. La date d’adhésion à la communauté ne fait pas partie du résultat.

Si aucune des communautés d’une requête n’est trouvée, la tâche échoue et les crédits sont intégralement remboursés. Si seules certaines manquent, les membres des autres sont tout de même renvoyés.