x/
post-replies

Raccogli le risposte pubbliche da uno o più URL di post di X, con testo delle risposte, autori, engagement visibile, media e contesto del post padre, con limiti per post e ordinamento.

X Post Replies API

Conversazioni dei post
Ordinamento delle risposte
Contesto del post padre
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 Post Replies

Le risposte ai post di X sono reazioni pubbliche all’interno di una conversazione, con testo, identità dell’autore, lingua, media, engagement visibile, ora di pubblicazione e link ai post padre o correlati. Questi record di conversazione supportano l’analisi delle risposte, la ricostruzione dei thread, il monitoraggio delle risposte e la preparazione di dataset per lo smistamento.

Funzionalità della X Post Replies API

  • Ambito della conversazione di un post notoAccetta uno o più URL pubblici di status di X, estrae l’ID numerico di ogni post e restituisce le risposte escludendo il post padre inviato.
  • Record di risposte e autoriRestituisce ID delle risposte, URL canonici, testo, lingua, orari di pubblicazione e identità pubblica normalizzata dell’autore per ogni risposta salvata.
  • Segnali visibili di rispostaMantiene insieme i conteggi pubblici di Mi piace, risposte, repost, citazioni, visualizzazioni e segnalibri con media, hashtag e menzioni.
  • Ordinamento selezionabile della timelineRichiedi l’ordinamento per pertinenza, più recenti o Mi piace per ogni post inviato, applicando un limite di risultati separato a ciascuna conversazione.
  • Tracciabilità della conversazioneConserva nel contesto normalizzato l’URL inviato, l’ID del post padre, l’ID della conversazione, il destinatario della risposta, la fonte e i segnali di citazione, repost e risposte limitate.

Parametri della X Post Replies API

ParametriObbligatorioDescrizione
urlsObbligatorioArray obbligatorio di URL pubblici di post di x.com o twitter.com. Ogni percorso deve contenere /status/{numeric_id}; sono accettate le varianti di host www, m e mobile.
results_limitFacoltativoNumero massimo di risposte richieste per ogni post padre. Il valore predefinito è 100 e sono accettati multipli di 20 da 20 a 2.000.
sort_byFacoltativoOrdinamento della timeline delle risposte applicato a ogni post inviato: relevance, latest o likes. Il valore predefinito è relevance.

Come usare la X Post Replies API

Invia URL pubblici noti di post come attività asincrona, poi leggi i record normalizzati delle risposte dall’attività completata.

  1. Prepara uno o più URL pubblici x.com o twitter.com che contengono un /status/{id} numerico, poi scegli l’ordinamento relevance, latest o likes.
  2. Invia con POST urls, un results_limit per post da 20 a 2.000 a passi di 20 e sort_by a /v1/x/post-replies.
  3. Conserva il task_id restituito e interroga GET /v1/tasks/{task_id} mentre l’attività è queued, running o retrying.
  4. Dopo il successo, leggi data.results.items e richiedi la stessa attività con cursor=data.results.next_cursor finché data.results.has_more è true.
curl -X POST "https://api.socq.ai/v1/x/post-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100,"sort_by":"relevance"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is true

Casi d’uso della X Post Replies API

  • Analisi delle risposte pubbliche: Confronta testo delle risposte, lingua, autori ed engagement visibile tra post padre selezionati per esaminare come si differenziano le conversazioni pubbliche.
  • Ricostruzione dei thread di conversazione: Usa parent_post_id, conversation_id, i campi in_reply_to, gli ID delle risposte e gli URL canonici per ricollegare le risposte salvate al loro contesto visibile del thread.
  • Monitoraggio delle risposte tra più raccolte: Segui orari di pubblicazione delle risposte, collected_at, autori e contatori pubblici per un insieme stabile di URL di post attraverso istantanee programmate.
  • Preparazione di dataset per lo smistamento manuale: Combina testo delle risposte, identità degli autori, timestamp, URL ed engagement visibile per preparare record di risposta destinati alle code di revisione a valle.

Consigli degli esperti per la X Post Replies API

  • Convalida ogni URL rispetto a un host accettato di X o Twitter e a un ID numerico /status/ prima dell’invio, così i link a profili e ricerche non creano attività fallite.
  • Estrai e deduplica l’ID numerico dello status tra le varianti di URL x.com e twitter.com, perché stringhe URL diverse possono puntare allo stesso post padre.
  • Dimensiona results_limit per post padre a passi di 20; i candidati totali possono avvicinarsi a urls × results_limit prima della fine delle conversazioni e della deduplicazione a livello di attività.
  • Scegli sort_by in base all’obiettivo della raccolta, ma non confrontare le posizioni tra le modalità relevance, latest e likes come se fossero un punteggio di classifica condiviso.
  • Quando ricostruisci molte conversazioni di post padre, tieni conto della deduplicazione delle risposte a livello di attività, perché una risposta salvata conserva un solo URL inviato e un solo contesto di post padre.
  • Considera un risultato breve o vuoto come un esito legato alla visibilità pubblica e salva i campi nullable di autore, media, metriche e relazioni senza inventare segnaposto.

Oltre alla X Post Replies 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 Profile Scraper API — Recupera identità dell’account pubblico, bio, avatar, immagini di copertina, stato dell’account e statistiche visibili del pubblico a partire dal nome utente.
  • Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
  • Twitter Search API — Trova post pubblici tramite espressione di ricerca con ordinamento per più recenti o più popolari e un limite di risultati configurabile.
  • 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 User Replies API — Raccoglie le risposte scritte da un account, ciascuna abbinata al post a cui risponde.

Esplora altre piattaforme

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

X Post Replies API — FAQ

X Post Replies API è un’interfaccia programmatica per raccogliere le risposte pubbliche da uno o più URL di post di X che contengono ID numerici di status. Restituisce testo delle risposte, autori, engagement visibile, media, timestamp e contesto della conversazione padre.

Invia un array urls non vuoto con link pubblici di post di x.com o twitter.com che hanno /status/{numeric_id} nel percorso. Sono accettate le varianti di host standard, www, m e mobile.

results_limit ha come valore predefinito 100, accetta multipli di 20 da 20 a 2.000 e si applica separatamente a ogni post padre. Una conversazione può finire prima del limite richiesto.

sort_by seleziona la modalità corrispondente della timeline pubblica delle risposte per ogni post inviato, con relevance come valore predefinito. Considera l’ordine restituito come quella modalità di raccolta selezionata e non come un punteggio di classifica separato di SocQ.

Una risposta può includere ID, URL, testo, lingua, autore pubblico, conteggi visibili, media, hashtag, menzioni, orari di pubblicazione e di raccolta, più i campi di conversazione e post padre in extra.

Il post padre inviato è escluso dai suoi risultati di risposta. Gli ID delle risposte vengono deduplicati durante la raccolta e di nuovo quando i risultati dell’attività vengono salvati, quindi le ripetizioni possono ridursi a un solo record.

Rami di risposte nascosti, eliminati, protetti, limitati, non disponibili o scollegati possono non essere visibili pubblicamente. La raccolta si ferma anche quando la conversazione visibile termina o viene raggiunto il limite richiesto per post.

No. Restituisce i post di risposta nelle conversazioni selezionate; i post con citazione e i profili che hanno ripubblicato un post sono risorse X separate.

Ogni risposta normalizzata salvata costa 0,5 crediti. La fatturazione usa il numero effettivo di record salvati, quindi un risultato vuoto non ha alcun costo per unità di risultato.