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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liens de communautés X publiques au format https://x.com/i/communities/<numeric_id>, un par ligne. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} en POST à /v1/x/community-members.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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.
API associées
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.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters 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 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