x/
thread-context

Lea el contexto que rodea a un post de X a partir de su enlace, con el post objetivo, los posts anteriores a los que responde y las respuestas públicas, junto con los ID de relación.

X Thread Context API

El post y su contexto
Qué post responde a cuál
Agrupación de la conversación
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

X Thread Context

Un hilo de X conecta un post con el mensaje al que responde, con los mensajes anteriores de esa cadena de respuestas y con las respuestas que le siguen, y no se limita a agrupar posts publicados en el mismo período. Conservar esas relaciones junto con el texto del post y los datos del autor ayuda a seguir cómo se desarrolló una discusión y a entender el contexto de un mensaje individual.

Funcionalidades de la X Thread Context API

  • Leer el post seleccionado con la discusión que lo rodeaUse el enlace de un post para recopilar el mensaje objetivo junto con los mensajes públicos anteriores de su cadena de respuestas y las respuestas disponibles que le siguen, de modo que tenga contexto más allá del mensaje seleccionado.
  • Entender qué posts van juntos y quién responde a quiénAdemás del texto, los autores y los conteos de interacción, conversation_id identifica la conversación a la que pertenece un post e in_reply_to_id identifica el post al que responde directamente, lo que le da vínculos entre los registros individuales.

Parámetros de la X Thread Context API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de enlaces públicos de posts de X que contengan /status/ seguido de un ID de post numérico, como https://x.com/BaganiTohid/status/2110635249889919362; en el Playground ponga un enlace por línea o use una lista JSON urls, y no enlaces de perfiles ni de comunidades.
results_limitOpcionalMáximo opcional de registros de contexto para cada post de entrada, de 1 a 2000, con 100 como valor predeterminado; dos enlaces de posts con un límite de 20 solicitan cada uno hasta 20 registros relacionados, y no comparten un total de 20.

Cómo usar la X Thread Context API

La solicitud inicia una tarea de recopilación en segundo plano, por lo que la primera respuesta contiene un ID de tarea y no los datos finales; use ese ID para consultar el progreso y obtener los resultados.

  1. Copie el enlace público del post que quiere entender y elija cuántos registros de contexto solicitar para él; si tiene varios enlaces, ponga cada uno en la lista urls.
  2. Antes de ejecutar el ejemplo, reemplace $SOCQ_API_KEY por su propia clave de API o defina esa variable de entorno. Envíe los datos JSON por POST a /v1/x/thread-context con el encabezado Authorization que se muestra a continuación y guarde el task_id de la respuesta.
  3. Use GET /v1/tasks/{task_id} con el ID guardado para consultar el progreso. queued significa en espera, running significa que la recopilación está en curso y retrying significa que se está realizando otro intento. Espere a succeeded antes de leer los resultados; si la tarea tiene el estado failed, lea error_message para conocer el motivo.
  4. Cuando la tarea finalice con éxito, lea data.results.items: cada elemento de esta lista describe un post y sus relaciones de conversación disponibles. Una lista vacía significa que la tarea terminó sin devolver registros.
  5. Si data.results.has_more es true, el valor next_cursor es el marcador de otra página de resultados guardados. Cópielo sin cambios en el parámetro cursor de GET /v1/tasks/{task_id}?cursor=... y continúe hasta que has_more sea 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}'

Casos de uso de la X Thread Context API

  • Revisar un mensaje con el contexto necesario para leerlo: Coloque el post objetivo junto a los mensajes anteriores y las respuestas devueltos, con su texto y sus autores, para preparar una vista de lectura para quien revise a qué respondía el mensaje seleccionado.
  • Crear un mapa de las relaciones de respuesta devueltas: Agrupe los posts por conversation_id y haga coincidir cada in_reply_to_id con el id de otro registro para trazar los vínculos de respuesta presentes, dejando visibles los huecos cuando no se devolvió un post al que se hace referencia.
  • Preparar el material de origen de un resumen de conversación: Guarde el texto de los posts, los nombres de los autores, las horas y las relaciones de respuesta como un conjunto de lectura ordenado para un paso de resumen independiente, realizado por una persona o por software, y no espere un resumen terminado en la respuesta.

Consejos de expertos para la X Thread Context API

  • Al ordenar una discusión para leerla, conecte primero los posts mediante sus ID de relación y use la hora de publicación solo como contexto de apoyo, porque una lista ordenada solo por tiempo no indica a qué mensaje responde cada post.
  • Si in_reply_to_id hace referencia a un ID que no está en sus registros guardados, conserve esa referencia como un vínculo faltante en lugar de asociar la respuesta a otro post o inventar el texto que falta.
  • Cuando varios enlaces enviados pertenezcan a la misma conversación, combine los resultados guardados por ID de post para que un post anterior compartido no aparezca varias veces en su conjunto de lectura.
  • Si solo necesita las respuestas de un post seleccionado, use X Post Replies; si solo necesita el propio post seleccionado, use X Posts en lugar de recopilar el contexto que lo rodea.

Además de la X Thread Context API, use estas APIs cuando necesite otro tipo de datos públicos de X.

  • Twitter Tweet Scraper API — Obtiene el texto de posts públicos, autores, interacción, contenido multimedia, hashtags, menciones y relaciones de conversación desde URLs de estado de x.com o twitter.com.
  • Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
  • X Post Quotes API — Recolecta posts públicos con cita de URLs de estado conocidas, con comentario, autores, interacción, contenido multimedia, marcas de tiempo y contexto del post de origen.
  • X Post Replies API — Recolecta respuestas públicas de URLs de posts de X con orden seleccionable, texto de la respuesta, autores, interacción visible, contenido multimedia y contexto del post principal.
  • Twitter Mentions API — Recolecta posts públicos que mencionan a una cuenta indicada.
  • X Community Posts API — Lee los posts públicos compartidos en una comunidad, con su texto, autores y conteos de interacción.

Explorar otras plataformas

Combine los datos de X con datos públicos de otras plataformas sociales compatibles.

X Thread Context API — FAQ

X Thread Context API es una interfaz programática para recuperar el contexto de discusión público a partir de enlaces de posts de X. Devuelve el post objetivo, los posts anteriores de su cadena de respuestas, las respuestas disponibles y los ID de relación que muestran cómo se conectan los posts devueltos.

El objetivo es el post cuyo enlace usted envía. Los posts anteriores, que a veces se llaman ancestros, son los mensajes a los que se llega siguiendo hacia atrás las relaciones de respuesta del objetivo, y no todos los posts publicados antes que él.

Si A publica un post y B responde a A, el in_reply_to_id de B contiene el ID del post de A. conversation_id agrupa los posts en la misma conversación, mientras que in_reply_to_id identifica el vínculo directo de respuesta; si C responde a B, C apunta a B y no directamente a A.

Thread Context incluye el post seleccionado y los posts públicos anteriores de su cadena de respuestas, además de las respuestas. X Post Replies se centra en las respuestas al post indicado, por lo que se ajusta a una tarea de recopilación de respuestas más acotada.

No. El límite y la visibilidad pública pueden dejar huecos, y un ID de relación puede hacer referencia a un post que no está incluido en sus resultados. Conserve los vínculos disponibles sin suponer mensajes faltantes ni su significado.

No. El cursor lee otra página de registros que esta tarea ya guardó; no inicia otra recopilación ni aumenta el límite de resultados original.

Cada registro de post devuelto cuesta 0.5 créditos, sin cargo base. Dos enlaces con un límite de 100 estiman 100 créditos; si la tarea devuelve 30 posts en total, el cargo final es de 15 créditos.