x/
thread-context

Leggi il contesto di un post di X a partire dal suo link: il post di destinazione, i post precedenti a cui risponde e le risposte pubbliche vengono restituiti insieme agli ID delle relazioni.

X Thread Context API

Il post e il suo contesto
Quale post risponde a quale
Raggruppamento delle conversazioni
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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_limitFacoltativoNumero 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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.

Esplora altre piattaforme

Combina i dati di X con i dati pubblici delle altre piattaforme social supportate.

X Thread Context API — FAQ

X Thread Context API è un’interfaccia programmatica per recuperare il contesto delle discussioni pubbliche a partire dai link ai post di X. Restituisce il post di destinazione, i post precedenti lungo la sua catena di risposte, le risposte disponibili e gli ID delle relazioni che mostrano come i post restituiti sono collegati.

Il post di destinazione è quello di cui invii il link. I post precedenti, a volte chiamati antenati, sono i messaggi che si raggiungono seguendo all’indietro le relazioni di risposta del post di destinazione, non tutti i post pubblicati prima di esso.

Se A pubblica un post e B risponde ad A, l’in_reply_to_id di B contiene l’ID del post di A. conversation_id raggruppa i post nella stessa conversazione, mentre in_reply_to_id identifica il collegamento diretto di risposta; se C risponde a B, C punta a B e non direttamente ad A.

Thread Context include il post selezionato e i post pubblici precedenti lungo la sua catena di risposte, oltre alle risposte. X Post Replies si concentra sulle risposte al post indicato, quindi si adatta a una raccolta di risposte più circoscritta.

No. Il limite e la visibilità pubblica possono lasciare lacune, e un ID di relazione può riferirsi a un post non incluso nei tuoi risultati. Conserva i collegamenti disponibili senza dare per scontati i messaggi mancanti o il loro significato.

No. Il cursore legge un’altra pagina di record già salvati da questa attività; non avvia una nuova raccolta e non aumenta il limite di risultati originale.

Ogni record di post restituito costa 0,5 crediti, senza costo base. Due link con un limite di 100 stimano 100 crediti; se l’attività restituisce 30 post in totale, l’addebito finale è di 15 crediti.