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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista 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_limit | Opcional | Má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.
- 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.
- 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.
- 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.
- 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.
- 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.
APIs relacionadas
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.
- 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