X Thread Context
Un thread di X collega un post al messaggio a cui risponde, ai messaggi precedenti lungo quella catena di risposte e alle risposte che seguono, invece di raggruppare semplicemente i post pubblicati nello stesso periodo. Conservare queste relazioni insieme al testo del post e alle informazioni sull’autore aiuta a seguire come si è sviluppata una discussione e a capire il contesto di un singolo messaggio.
Funzionalità della X Thread Context API
- Leggere il post selezionato insieme alla discussione che lo circondaUsa il link di un post per raccogliere il messaggio di destinazione insieme ai messaggi pubblici precedenti lungo la sua catena di risposte e alle risposte disponibili che seguono, così hai un contesto che va oltre il solo messaggio selezionato.
- Capire quali post vanno insieme e chi risponde a chiOltre a testo, autori e conteggi delle interazioni, conversation_id identifica la conversazione a cui appartiene un post e in_reply_to_id identifica il post a cui risponde direttamente, offrendoti i collegamenti tra i singoli record.
Parametri della X Thread Context API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di link a post pubblici di X che contengono /status/ seguito da un ID numerico del post, come https://x.com/BaganiTohid/status/2110635249889919362; inserisci un link per riga nel Playground oppure usa un array JSON urls, senza link a profili o community. |
results_limit | Facoltativo | Numero massimo facoltativo di record di contesto per ogni post in input, da 1 a 2000, con 100 come valore predefinito; due link a post con un limite di 20 richiedono ciascuno fino a 20 record correlati, anziché condividere un totale di 20. |
Come usare la X Thread Context API
La richiesta avvia un’attività di raccolta in background, quindi la prima risposta contiene un ID attività anziché i dati completi; usa quell’ID per controllare l’avanzamento e recuperare i risultati.
- Copia il link del post pubblico che vuoi capire e scegli quanti record di contesto richiedere; se hai più link, inserisci ciascuno nell’elenco urls.
- Prima di eseguire l’esempio, sostituisci $SOCQ_API_KEY con la tua chiave API o imposta quella variabile d’ambiente. Invia l’input JSON a POST /v1/x/thread-context con l’intestazione Authorization mostrata sotto, poi salva il task_id della risposta.
- Usa GET /v1/tasks/{task_id} con l’ID salvato per controllare l’avanzamento. queued significa in attesa, running significa raccolta in corso e retrying significa che è in corso un nuovo tentativo. Attendi succeeded prima di leggere i risultati; se l’attività è failed, leggi error_message per conoscere il motivo.
- Quando l’attività ha successo, leggi data.results.items: ogni elemento di questo elenco descrive un post e le sue relazioni di conversazione disponibili. Un elenco vuoto significa che l’attività si è conclusa senza restituire alcun record.
- Se data.results.has_more è true, il valore next_cursor è il segnaposto per un’altra pagina di risultati salvati. Copialo senza modifiche nel parametro cursor di GET /v1/tasks/{task_id}?cursor=... e continua finché has_more è 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}'Casi d’uso della X Thread Context API
- Rivedere un messaggio con il contesto necessario per leggerlo: Affianca il post di destinazione ai messaggi precedenti e alle risposte restituiti, compresi testo e autori, per preparare una vista di lettura utile a chi vuole verificare a che cosa rispondeva il messaggio selezionato.
- Costruire una mappa delle relazioni di risposta restituite: Raggruppa i post per conversation_id e abbina ogni in_reply_to_id all’id di un altro record per tracciare i collegamenti di risposta presenti, lasciando visibili le lacune quando un post a cui si fa riferimento non è stato restituito.
- Preparare il materiale di partenza per il riassunto di una conversazione: Salva il testo dei post, i nomi degli autori, gli orari e le relazioni di risposta come insieme di lettura ordinato per un passaggio di sintesi separato, umano o software, anziché aspettarti un riassunto già pronto nella risposta.
Consigli degli esperti per la X Thread Context API
- Quando organizzi una discussione per la lettura, collega prima i post tramite i loro ID di relazione e usa l’orario di pubblicazione solo come contesto di supporto, perché un elenco ordinato per tempo non dice a quale messaggio risponde ciascun post.
- Se in_reply_to_id fa riferimento a un ID assente dai tuoi record salvati, conserva quel riferimento come collegamento mancante invece di agganciare la risposta a un altro post o di inventare il testo mancante.
- Quando più link inviati appartengono alla stessa conversazione, unisci i risultati salvati per ID del post, così un post precedente condiviso non compare più volte nel tuo insieme di lettura.
- Se ti servono solo le risposte a un post selezionato, usa X Post Replies; se ti serve solo il post selezionato, usa X Posts invece di raccogliere il contesto circostante.
API correlate
Oltre alla X Thread Context API, usa queste API quando ti serve un altro tipo di dati pubblici di X.
- Twitter Tweet Scraper API — Recupera testo dei post pubblici, autori, engagement, media, hashtag, menzioni e relazioni della conversazione dagli URL di stato di x.com o twitter.com.
- Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
- X Post Quotes API — Raccoglie le citazioni pubbliche di URL di stato noti con commento, autori, engagement, media, date e contesto del post di origine.
- X Post Replies API — Raccoglie le risposte pubbliche dagli URL dei post X con ordinamento selezionabile, testo delle risposte, autori, engagement visibile, media e contesto del post principale.
- Twitter Mentions API — Raccoglie i post pubblici che menzionano un account indicato.
- X Community Posts API — Leggi i post pubblici condivisi in una community, con testo, autori e conteggi delle interazioni.
- 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