x/
post-replies

Collectez les réponses publiques d’une ou plusieurs URL de posts X et obtenez texte, auteurs, engagement visible, médias et contexte du post parent, avec limites et tri par post.

X Post Replies API

Conversations autour d’un post
Ordre des réponses
Contexte du post parent
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 Post Replies

Les réponses à un post X sont des messages publics au sein de sa conversation, avec leur texte, l’identité de l’auteur, la langue, les médias, l’engagement visible, la date de publication et des liens vers les posts parents ou associés. Ces enregistrements de conversation servent à analyser les réactions, à reconstituer des fils, à surveiller les réponses et à préparer des jeux de données de tri.

Fonctionnalités de la X Post Replies API

  • Conversation d’un post connuAcceptez une ou plusieurs URL de statuts X publics, extrayez l’ID numérique de chaque post et renvoyez les réponses, sans inclure le post parent envoyé lui-même.
  • Réponses et auteursRenvoie, pour chaque réponse sauvegardée, l’ID, l’URL canonique, le texte, la langue, la date de publication et l’identité publique normalisée de l’auteur.
  • Signaux de réaction visiblesRéunit les nombres publics de mentions « J’aime », de réponses, de reposts, de citations, de vues et de favoris avec les médias, hashtags et mentions.
  • Ordre de la chronologie au choixDemandez un tri par pertinence, par récence (latest) ou par mentions « J’aime » (likes) pour chaque post envoyé, avec une limite de résultats distincte pour chaque conversation.
  • Traçabilité de la conversationConserve dans le contexte normalisé l’URL envoyée, l’ID du post parent, l’ID de conversation, la cible de la réponse, ainsi que les signaux de source, de citation, de repost et de réponses limitées.

Paramètres de la X Post Replies API

ParamètresObligatoireDescription
urlsObligatoireTableau obligatoire d’URL de posts publics x.com ou twitter.com. Chaque chemin doit contenir /status/{numeric_id} ; les variantes d’hôte www, m et mobile sont acceptées.
results_limitFacultatifNombre maximal de réponses demandées par post parent. Vaut 100 par défaut et accepte les multiples de 20 de 20 à 2 000.
sort_byFacultatifTri de la chronologie des réponses appliqué à chaque post envoyé : relevance, latest ou likes. La valeur par défaut est relevance.

Comment utiliser la X Post Replies API

Envoyez des URL de posts publics connues sous forme de tâche asynchrone, puis lisez les enregistrements de réponses normalisés une fois la tâche terminée.

  1. Préparez une ou plusieurs URL publiques x.com ou twitter.com contenant un /status/{id} numérique, puis choisissez le tri relevance, latest ou likes.
  2. Envoyez urls, un results_limit par post de 20 à 2 000 par pas de 20, et sort_by en POST à /v1/x/post-replies.
  3. Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} tant que la tâche est en queued, running ou retrying.
  4. Après un succès, lisez data.results.items et interrogez la même tâche avec cursor=data.results.next_cursor tant que data.results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/post-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100,"sort_by":"relevance"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is true

Cas d’usage de la X Post Replies API

  • Analyse des réactions du public : Comparez texte des réponses, langue, auteurs et engagement visible sur une sélection de posts parents pour voir en quoi leurs conversations publiques diffèrent.
  • Reconstitution des fils de conversation : Servez-vous de parent_post_id, conversation_id, des champs in_reply_to, des ID de réponses et des URL canoniques pour rattacher les réponses sauvegardées au contexte visible de leur fil.
  • Surveillance des réponses d’une collecte à l’autre : Suivez les dates de publication des réponses, collected_at, les auteurs et les compteurs publics d’un ensemble stable d’URL de posts, à travers des instantanés planifiés.
  • Préparation d’un jeu de données pour le tri manuel : Combinez texte des réponses, identité des auteurs, horodatages, URL et engagement visible pour préparer des enregistrements destinés aux files de revue en aval.

Conseils d’expert pour la X Post Replies API

  • Vérifiez chaque URL avant l’envoi : hôte X ou Twitter accepté et ID numérique après /status/, afin que les liens de profil et de recherche ne créent pas de tâches en échec.
  • Extrayez et dédoublonnez l’ID de statut numérique entre les variantes d’URL x.com et twitter.com, car des chaînes d’URL différentes peuvent pointer vers le même post parent.
  • Dimensionnez results_limit par post parent, par pas de 20 ; le total de candidats peut approcher urls × results_limit avant la fin des conversations et le dédoublonnage au niveau de la tâche.
  • Choisissez sort_by selon l’objectif de collecte, mais ne comparez pas les positions entre les modes relevance, latest et likes comme s’il s’agissait d’un score de classement commun.
  • Pour reconstituer de nombreuses conversations parentes, tenez compte du dédoublonnage des réponses au niveau de la tâche : une réponse sauvegardée ne conserve qu’une URL envoyée et un seul contexte de post parent.
  • Voyez dans un résultat court ou vide un effet de la visibilité publique, et stockez les champs nullables d’auteur, de média, de métriques et de relations sans inventer de valeurs de remplacement.

En complément de la X Post Replies 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 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.
  • 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.
  • Twitter Search API — Trouvez des posts publics par expression de recherche, avec tri par récents ou populaires et limite de résultats configurable.
  • 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.
  • X User Replies API — Collectez les réponses écrites par un compte, chacune accompagnée du post auquel elle répond.

Explorer d’autres plateformes

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

X Post Replies API — FAQ

X Post Replies API est une interface programmatique qui collecte les réponses publiques d’une ou plusieurs URL de posts X contenant des ID de statut numériques. Elle renvoie texte des réponses, auteurs, engagement visible, médias, horodatages et contexte de la conversation parente.

Envoyez un tableau urls non vide de liens de posts publics x.com ou twitter.com dont le chemin contient /status/{numeric_id}. Les variantes d’hôte standard, www, m et mobile sont acceptées.

results_limit vaut 100 par défaut, accepte les multiples de 20 de 20 à 2 000 et s’applique séparément à chaque post parent. Une conversation peut se terminer avant la limite demandée.

sort_by sélectionne le mode correspondant de la chronologie publique des réponses pour chaque post envoyé, relevance étant la valeur par défaut. Voyez dans l’ordre renvoyé ce mode de collecte, et non un score de classement distinct de SocQ.

Une réponse peut inclure son ID, son URL, son texte, sa langue, son auteur public, les nombres visibles, les médias, les hashtags, les mentions, les dates de publication et de collecte, ainsi que les champs de conversation et de post parent dans extra.

Le post parent envoyé est exclu de ses résultats de réponses. Les ID de réponses sont dédoublonnés pendant la collecte puis de nouveau à la sauvegarde des résultats de la tâche : des apparitions répétées peuvent donc se réduire à un seul enregistrement.

Des branches de réponses masquées, supprimées, protégées, limitées, indisponibles ou déconnectées peuvent ne pas être visibles publiquement. La collecte s’arrête aussi lorsque la conversation visible se termine ou que la limite demandée par post est atteinte.

Non. Il renvoie les réponses des conversations sélectionnées ; les posts de citation et les profils ayant reposté un post sont des ressources X distinctes.

Chaque réponse normalisée sauvegardée coûte 0,5 crédit. La facturation repose sur le nombre réel d’enregistrements sauvegardés : un résultat vide n’entraîne donc aucun frais par unité de résultat.