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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste 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.
- Ouvrez la page publique de la communauté et copiez son lien /i/communities/ ; préparez un lien par communauté à consulter.
- 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.
- 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.
- 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.
- 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.
API associées
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.
- 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 Thread Context API
- X Account Location 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