X User Replies
L’onglet Réponses d’un profil X (Twitter) contient les réponses qu’un compte a écrites à d’autres tweets, de la plus récente à la plus ancienne, chacune rattachée à une conversation et au post auquel elle répond, avec l’auteur et le texte de ce post. Mises côte à côte, les réponses et les posts auxquels elles répondent montrent à qui un compte s’adresse, ce qu’il dit en marge de sa timeline principale et comment il gère les questions et les critiques.
Fonctionnalités de la X User Replies API
- Les réponses écrites par un compteEnvoyez un nom d’utilisateur, avec ou sans @ initial, et recevez les réponses publiées par ce compte, lues dans son onglet Réponses et triées de la plus récente à la plus ancienne.
- Le post d’origine sur la même lignein_reply_to contient l’id, l’url, le texte, l’auteur et le published_at du post auquel chaque réponse s’adresse : chaque échange se lit directement dans le résultat.
- ID de conversation et de post parentconversation_id et in_reply_to_id rattachent chaque réponse à son fil et au post exact situé au-dessus, ce qui permet de regrouper les réponses par conversation.
- Texte, médias et engagement de chaque réponseChaque réponse est fournie avec son texte, les images ou vidéos jointes éventuelles et les nombres de mentions « J’aime », de commentaires, de partages et de vues.
Paramètres de la X User Replies API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Nom d’utilisateur X dont vous voulez collecter les réponses, avec ou sans le @ initial. |
results_limit | Facultatif | Nombre de réponses à renvoyer, de 1 à 1 000. 20 par défaut. |
Comment utiliser la X User Replies API
Envoyez un nom d’utilisateur et lisez ses réponses avec les posts auxquels elles répondent.
- Envoyez {"username": "elonmusk", "results_limit": 20} en POST à /v1/x/user-replies.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status passe à succeeded.
- Lisez les réponses dans results.items, avec le post d’origine dans in_reply_to, et transmettez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/x/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"elonmusk","results_limit":20}'
# in_reply_to holds the post each reply answers: its text, author, url and publish time.Cas d’usage de la X User Replies API
- Cartographier les interlocuteurs d’un compte : Comptez in_reply_to.author.username sur l’ensemble des réponses d’un compte pour lister les personnes et les marques avec lesquelles il échange le plus souvent.
- Auditer les réponses du service client d’une marque : Lisez le text de chaque réponse à côté de in_reply_to.text et soustrayez in_reply_to.published_at de published_at pour mesurer la rapidité et la qualité des réponses d’un compte d’assistance.
- Suivre ce qu’une personnalité publique dit en réponse : Collectez à intervalles réguliers les réponses d’un dirigeant ou d’un responsable politique pour capter les déclarations faites au fil des conversations, en gardant url comme lien source.
- Constituer des paires post-réponse pour l’analyse : Associez in_reply_to.text à text pour assembler des jeux de données d’échanges destinés à étudier le ton, les prises de position ou les sujets dans la manière dont un compte répond.
Conseils d’expert pour la X User Replies API
- Retirez les @identifiants placés au début de text avant de mesurer le sentiment ou la longueur, car une réponse commence par l’identifiant du compte auquel elle répond.
- Regroupez les réponses par conversation_id pour voir tous les messages que le compte a laissés dans un même fil.
- Quand in_reply_to.text ou son auteur est vide, gardez la réponse et stockez in_reply_to.url pour pouvoir retrouver plus tard le post d’origine.
- Utilisez X Post Replies API avec des URL de posts pour obtenir ce que d’autres personnes ont répondu aux posts du compte ; X User Replies API couvre les réponses écrites par le compte.
API associées
En complément de la X User 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 Replies API — Collectez les réponses publiques à partir d’URL de posts X avec tri au choix, texte des réponses, auteurs, engagement visible, médias et contexte du post parent.
- 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 Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts 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