x/
community

Lisez les informations publiques de communautés X à partir de leurs liens, avec descriptions, nombres de membres et règles, et interrogez plusieurs communautés à la fois.

X Community API

Détails de la communauté
Nombres de membres et de modérateurs
Règles et conditions d’adhésion
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 Community

Une communauté X est un espace de discussion thématique doté d’un nom, d’une description, de compteurs de membres et de règles de participation. Ces informations permettent de cerner le sujet de la communauté, de comparer sa taille à celle d’autres communautés et de vérifier ses conditions de participation avant d’explorer les discussions.

Fonctionnalités de la X Community API

  • Comprendre le sujet d’une communautéObtenez ensemble le nom de la communauté, sa description publique, son lien, son image de couverture et les informations sur son créateur, afin d’identifier l’espace et de lire le thème annoncé avant de chercher des posts.
  • Connaître sa taille et ses conditions de participationRecevez les nombres de membres et de modérateurs, ainsi que join_policy et invites_policy, qui décrivent la façon dont l’adhésion et l’invitation de membres sont gérées.
  • Lire les règles propres à la communautéLa liste des règles comprend leurs noms et leurs descriptions, de quoi conserver les exigences de participation à côté des informations de base de la communauté.

Paramètres de la X Community API

ParamètresObligatoireDescription
urlsObligatoireListe obligatoire de liens publics de communautés X comportant un ID de communauté numérique, tels que https://x.com/i/communities/1493446837214187523 ; dans le Playground, mettez un lien par ligne, ou utilisez un tableau JSON urls dans le code, et non un lien de profil, de recherche ou de post isolé.

Comment utiliser la X Community API

La requête lance une tâche de collecte en arrière-plan : sa première réponse vous donne donc un ID de tâche et non les données finales ; servez-vous de cet ID pour suivre l’avancement et récupérer les résultats.

  1. Ouvrez la page publique de la communauté et copiez son lien /i/communities/ ; préparez un lien par communauté à consulter.
  2. Avant de lancer l’exemple, remplacez $SOCQ_API_KEY par votre propre clé API ou définissez cette variable d’environnement. Envoyez l’entrée JSON en POST à /v1/x/community avec l’en-tête Authorization indiqué ci-dessous, puis conservez le task_id de la réponse.
  3. Appelez GET /v1/tasks/{task_id} avec l’ID conservé pour suivre l’avancement. queued signifie en attente, running que la collecte est en cours et retrying qu’une nouvelle tentative est en cours. Attendez succeeded avant de lire les résultats ; si la tâche est en failed, lisez error_message pour en connaître la raison.
  4. Une fois la tâche réussie, lisez data.results.items : chaque élément de cette liste décrit les informations d’une communauté. Une liste vide signifie que la tâche s’est terminée sans renvoyer d’enregistrement.
  5. Si data.results.has_more vaut true, la valeur next_cursor est le repère d’une autre page de résultats sauvegardés. Copiez-la telle quelle dans le paramètre cursor de GET /v1/tasks/{task_id}?cursor=... et continuez jusqu’à ce que has_more vaille false.
curl -X POST "https://api.socq.ai/v1/x/community" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"]}'

Cas d’usage de la X Community API

  • Constituer un annuaire de communautés à explorer : Réunissez noms, descriptions, liens et nombres de membres dans un tableau pour comparer les communautés fournies par thème et par taille avant de choisir quelles discussions lire.
  • Garder les règles avec la revue d’une discussion : Sauvegardez les règles et les conditions d’adhésion sous l’ID de la communauté, puis utilisez X Community Posts à part pour rattacher les posts à examiner au contexte de cette communauté.

Conseils d’expert pour la X Community API

  • Si vous partez d’un post plutôt que d’une page de communauté, retrouvez d’abord le lien public de la communauté, car cette recherche ne déduit pas la communauté d’un post à partir de l’URL du post.
  • Lorsque la même communauté apparaît avec des liens x.com et twitter.com, prenez l’ID numérique situé après /i/communities/ comme clé de rapprochement, pour ne pas créer de doublons dans l’annuaire.
  • Pour comparer des communautés, voyez dans le nombre de membres une mesure de taille et non la preuve de l’activité de publication ; ce résultat ne contient ni historique d’activité ni liste de membres individuels.

En complément de la X Community 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 Posts API — Lisez les posts publics partagés dans une communauté, avec leur texte, leurs auteurs et leurs nombres d’interactions.
  • X Community Members API — Exportez les membres d’une communauté sous forme de profils complets avec bio et nombre d’abonnés.
  • 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 API — FAQ

X Community API est une interface programmatique qui récupère les informations publiques de communautés X à partir d’une liste de liens. Elle renvoie noms, descriptions, nombres de membres et de modérateurs, règles et conditions d’adhésion, pour comprendre chaque communauté avant d’explorer ses posts.

Un lien de communauté contient /i/communities/ suivi d’un ID numérique. Un lien de profil pointe vers un compte et un lien /status/ vers un post : aucun des deux ne convient comme entrée de cette recherche.

Non. Un compteur indique combien de membres compte la communauté, pas qui ils sont ; la réponse ne contient aucun annuaire de membres.

Non. Cette recherche renvoie la description, les règles et les autres métadonnées de la communauté. Utilisez le même lien de communauté avec X Community Posts pour obtenir les discussions elles-mêmes.

Non. Les communautés X sont des espaces organisés autour de sujets de discussion communs. Les Community Notes sont des annotations de posts, et ces annotations ne sont pas l’objet renvoyé ici.

Chaque enregistrement de communauté renvoyé coûte 0,5 crédit, sans frais de base. Par exemple, quatre liens de communautés envoyés donnent une estimation de 2 crédits, et quatre enregistrements renvoyés coûtent 2 crédits.