x/
thread-context

Lisez le contexte d’un post X à partir de son lien : le post ciblé, les posts antérieurs auxquels il répond et les réponses publiques sont renvoyés ensemble avec leurs ID de relation.

X Thread Context API

Le post et son contexte
Quel post répond à quel autre
Regroupement par conversation
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 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ètresObligatoireDescription
urlsObligatoireListe 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_limitFacultatifNombre 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.

  1. 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.
  2. 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.
  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 a lieu. Attendez succeeded avant de lire les résultats ; si la tâche est failed, error_message en donne la raison.
  4. 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.
  5. 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.

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.

Explorer d’autres plateformes

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

X Thread Context API — FAQ

X Thread Context API est une interface programmatique pour récupérer le contexte d’une discussion publique à partir de liens de posts X. Elle renvoie le post ciblé, les posts antérieurs de sa chaîne de réponses, les réponses disponibles et les ID de relation qui montrent comment les posts renvoyés sont reliés.

Le post ciblé est celui dont vous envoyez le lien. Les posts antérieurs, parfois appelés ancêtres, sont les messages atteints en remontant les relations de réponse du post ciblé, et non tous les posts publiés avant lui.

Si A publie un post et que B lui répond, l’in_reply_to_id de B contient l’ID du post de A. conversation_id regroupe les posts d’une même conversation, tandis que in_reply_to_id désigne le lien de réponse direct ; si C répond à B, C pointe vers B et non directement vers A.

Thread Context inclut le post sélectionné et les posts publics antérieurs de sa chaîne de réponses, en plus des réponses. X Post Replies se concentre sur les réponses au post fourni, ce qui convient mieux à une collecte de réponses plus ciblée.

Non. La limite et la visibilité publique peuvent laisser des trous, et un ID de relation peut désigner un post absent de vos résultats. Conservez les liens disponibles sans supposer les messages manquants ni leur sens.

Non. Le curseur lit une autre page d’enregistrements déjà sauvegardés par cette tâche ; il ne lance pas de nouvelle collecte et n’augmente pas la limite de résultats initiale.

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