X Thread Context
Un thread X relie un post au message auquel il répond, aux messages antérieurs de cette chaîne de réponses et aux réponses qui suivent, au lieu de simplement regrouper des posts publiés à la même période. Garder ces liens avec le texte du post et les informations sur l’auteur aide à comprendre comment une discussion s’est déroulée et à situer chaque message dans son contexte.
Fonctionnalités de la X Thread Context API
- Lire le post choisi avec la discussion qui l’entoureÀ partir du lien d’un post, collectez le message ciblé avec les messages publics antérieurs de sa chaîne de réponses et les réponses disponibles qui suivent, pour disposer d’un contexte plus large que le seul message sélectionné.
- Savoir quels posts vont ensemble et qui répond à quiEn plus du texte, des auteurs et des compteurs d’interaction, conversation_id désigne la conversation à laquelle appartient un post et in_reply_to_id le post auquel il répond directement, ce qui vous donne les liens entre les enregistrements.
Paramètres de la X Thread Context API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire de liens de posts X publics contenant /status/ suivi d’un ID de post numérique, comme https://x.com/BaganiTohid/status/2110635249889919362 ; indiquez un lien par ligne dans le Playground ou utilisez un tableau JSON urls, et non des liens de profil ou de communauté. |
results_limit | Facultatif | Nombre maximal facultatif d’enregistrements de contexte pour chaque post fourni, de 1 à 2000, avec 100 par défaut ; deux liens de posts avec une limite de 20 demandent chacun jusqu’à 20 enregistrements associés, et non 20 au total. |
Comment utiliser la X Thread Context API
La requête lance une tâche de collecte en arrière-plan : sa première réponse contient 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 le lien du post public à explorer et choisissez le nombre d’enregistrements de contexte à demander ; avec plusieurs liens, placez-les tous dans la liste urls.
- Avant d’exécuter l’exemple, remplacez $SOCQ_API_KEY par votre propre clé API ou définissez cette variable d’environnement. Envoyez le JSON en POST à /v1/x/thread-context 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 a lieu. Attendez succeeded avant de lire les résultats ; si la tâche est failed, error_message en donne la raison.
- Une fois la tâche réussie, lisez data.results.items : chaque élément de cette liste décrit un post et ses relations de conversation disponibles. Une liste vide signifie que la tâche s’est terminée sans renvoyer aucun enregistrement.
- Si data.results.has_more vaut true, la valeur next_cursor est le repère d’une autre page de résultats enregistrés. Copiez-la telle quelle dans le paramètre cursor de GET /v1/tasks/{task_id}?cursor=... et poursuivez jusqu’à ce que has_more vaille false.
curl -X POST "https://api.socq.ai/v1/x/thread-context" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/BaganiTohid/status/2110635249889919362"],"results_limit":20}'Cas d’usage de la X Thread Context API
- Relire un message avec le contexte nécessaire pour le comprendre : Placez le post ciblé à côté des messages antérieurs et des réponses renvoyés, avec leur texte et leurs auteurs, pour préparer une vue de lecture destinée à quelqu’un qui vérifie à quoi le message sélectionné répondait.
- Construire une carte des relations de réponse renvoyées : Regroupez les posts par conversation_id et rapprochez chaque in_reply_to_id de l’id d’un autre enregistrement pour tracer les liens de réponse présents ; les trous restent visibles quand un post référencé n’a pas été renvoyé.
- Préparer la matière première d’un résumé de conversation : Enregistrez le texte des posts, les noms des auteurs, les heures et les relations de réponse sous la forme d’un ensemble de lecture ordonné pour une étape de synthèse distincte, humaine ou logicielle, plutôt que d’attendre un résumé tout fait dans la réponse.
Conseils d’expert pour la X Thread Context API
- Pour ordonner une discussion en vue de la lire, reliez d’abord les posts par leurs ID de relation et ne prenez l’heure de publication que comme contexte d’appoint : une liste triée par date ne dit pas à quel message chaque post répond.
- Si in_reply_to_id renvoie à un ID absent de vos enregistrements, gardez cette référence comme un lien manquant au lieu de rattacher la réponse à un autre post ou d’inventer le texte absent.
- Quand plusieurs liens envoyés relèvent de la même conversation, fusionnez les résultats enregistrés par ID de post pour qu’un post antérieur commun n’apparaisse pas plusieurs fois dans votre ensemble de lecture.
- Si seules les réponses à un post vous intéressent, utilisez X Post Replies ; si seul le post lui-même compte, utilisez X Posts plutôt que de collecter le contexte environnant.
API associées
En complément de la X Thread Context 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.
- 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.
- Twitter Mentions API — Collectez les posts publics qui mentionnent un compte donné.
- X Community Posts API — Lisez les posts publics partagés dans une communauté, avec leur texte, leurs auteurs et leurs nombres d’interactions.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community 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
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API