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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Tableau 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_limit | Facultatif | Nombre 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_by | Facultatif | Tri 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.
- 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.
- Envoyez urls, un results_limit par post de 20 à 2 000 par pas de 20, et sort_by en POST à /v1/x/post-replies.
- Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} tant que la tâche est en queued, running ou retrying.
- 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 trueCas 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.
API associées
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.
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts 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 Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- Twitter Follow Checker API
- Twitter Video Transcript API