x/
community-posts

Obtenez les posts publics de liens de communautés X, avec texte, auteurs et compteurs d’engagement réunis, et une limite de résultats distincte pour chaque communauté.

X Community Posts API

Lire les discussions d’une communauté
Texte des posts et auteurs
Une limite 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 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è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é.
results_limitFacultatifNombre 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.

  1. 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é.
  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-posts 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 un post de 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-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.

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.

Explorer d’autres plateformes

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

X Community Posts API — FAQ

X Community Posts API est une interface programmatique qui lit les posts publics d’une liste de liens de communautés X. Elle renvoie texte, auteurs, médias, horodatages et compteurs d’interaction par ordre de date de création, avec un plafond de résultats pour chaque communauté.

Une communauté rassemble les posts partagés dans cet espace de discussion, alors que la chronologie d’un profil rassemble les posts d’un seul compte. Fournissez ici des liens de communautés ; utilisez X User Posts lorsque le point de départ est le nom d’utilisateur d’un compte.

Non. Cela signifie jusqu’à 100 posts pour chaque lien de communauté. Par exemple, trois communautés peuvent demander jusqu’à 300 posts au total, même si la disponibilité publique et le dédoublonnage peuvent réduire le nombre final d’enregistrements.

La limite doit évoluer par pas de 20 : utilisez des valeurs comme 20, 40, 60 ou 100. La plage autorisée va de 20 à 2 000, et la valeur par défaut est 100.

Non. Le curseur d’une tâche permet de lire une autre page des résultats que cette tâche a déjà sauvegardés. Il n’augmente pas le plafond initial par communauté et ne lance aucune nouvelle collecte.

Non. Il renvoie des enregistrements de posts que vous pouvez lire, organiser ou confier à un processus de résumé distinct. Une synthèse ou une analyse achevée ne fait pas partie de la réponse.

Chaque post renvoyé coûte 0,7 crédit, sans frais de base. Deux liens de communautés avec une limite de 100 donnent une estimation de 140 crédits ; si la tâche renvoie 30 posts au total, le montant final est de 21 crédits.