X Community Posts
Les posts d’une communauté X sont des messages partagés au sein d’un groupe thématique, chacun avec un auteur, une heure de publication, un texte et d’éventuels médias joints. Lus avec leurs compteurs d’interactions, ils aident à structurer la matière des échanges et à comparer un à un les posts qui composent la conversation publique d’une communauté.
Fonctionnalités de la X Community Posts API
- Lire les posts de la communauté indiquéePartez du lien d’une communauté pour collecter les discussions publiques qui s’y tiennent, plutôt que l’ensemble des posts publiés sur le profil d’une personne.
- Un plafond distinct pour chaque communautéSi vous fournissez plusieurs liens de communautés, results_limit s’applique à chacun et les posts sont collectés par ordre de date de création : votre saisie fixe donc la taille de collecte de chaque espace de discussion.
- Le message et ses détails réunisChaque enregistrement de post contient son texte, les informations sur l’auteur, la date de publication, les médias et les compteurs d’interaction disponibles, ce qui permet de relire le message sans perdre de vue qui l’a publié ni quand.
Paramètres de la X Community Posts 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é. |
results_limit | Facultatif | Nombre maximal facultatif de posts par communauté ; vaut 100 par défaut et accepte les multiples de 20 de 20 à 2 000, comme 20, 40 ou 100 ; avec deux liens de communautés et une limite de 20, chaque communauté peut apporter jusqu’à 20 posts. |
Comment utiliser la X Community Posts 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.
- Copiez les liens des communautés à lire et choisissez une limite par communauté, par exemple 20 ou 100 ; utilisez un lien de communauté et non l’URL d’un post isolé.
- 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-posts 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 un post de 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-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":20}'Cas d’usage de la X Community Posts API
- Préparer la matière d’une synthèse de discussion : Organisez le texte des posts récupérés, les identifiants d’auteurs, les liens et les heures en une liste de lecture qu’une personne ou un outil de résumé distinct pourra exploiter pour rédiger une synthèse de ces posts.
- Comparer les compteurs d’interaction d’un post entre instantanés : Stockez les ID de posts et les compteurs renvoyés avec leurs heures de collecte, puis retrouvez les mêmes posts dans les collectes suivantes pour calculer vous-même l’évolution des nombres disponibles.
- Explorer la conversation autour d’un post choisi : Choisissez un post dans les résultats de la communauté et transmettez son URL à X Thread Context pour lire les posts et réponses antérieurs disponibles autour de ce message précis.
Conseils d’expert pour la X Community Posts API
- Pour planifier un lot, multipliez le nombre de liens de communautés par results_limit afin d’estimer le nombre d’enregistrements demandés, puis appliquez le tarif par post sans supposer que la limite est partagée entre toutes les communautés.
- Si vous répétez une collecte, rapprochez les posts par leurs ID avant de les ajouter à votre table sauvegardée, car un post peut réapparaître dans une tâche ultérieure.
- Si vous conservez les résultats de plusieurs communautés, sauvegardez les liens de communautés envoyés avec l’entrée de la tâche ; l’enregistrement de post standard ne garantit pas un ID de communauté capable de remplacer ce contexte de saisie.
API associées
En complément de la X Community Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques X.
- Twitter Tweet Scraper API — Récupérez le texte des posts publics, auteurs, l’engagement, médias, hashtags, mentions et relations de conversation à partir d’URL de statuts x.com ou twitter.com.
- Twitter User Tweets Scraper API — Collectez par nom d’utilisateur les posts publics récents, auteurs, médias, hashtags, mentions et l’engagement, hors réponses.
- X Post Quotes API — Collectez les citations publiques de statuts connus à partir de leur URL, avec commentaire, auteurs, engagement, médias, horodatages et contexte du post source.
- Twitter Mentions API — Collectez les posts publics qui mentionnent un compte donné.
- X Thread Context API — Lisez un post avec les messages précédents de sa chaîne de réponses, les réponses publiques et les ID de relation.
- X List Tweets API — Lisez la timeline d’une liste, du plus récent au plus ancien, avec les reposts signalés et leur auteur d’origine.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Account Location API
- X Verified Followers API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators 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