X User Replies
La scheda “Risposte” di un profilo X (Twitter) contiene le risposte che un account ha scritto ad altri tweet, dalla più recente, ognuna legata a una conversazione e al post a cui risponde, insieme all’autore e al testo di quel post. Messe una accanto all’altra, le risposte e i post a cui rispondono mostrano con chi parla un account, cosa dice lontano dalla sua timeline principale e come gestisce domande e critiche.
Funzionalità della X User Replies API
- Le risposte scritte da un accountInvia un nome utente, con o senza la @ iniziale, e ricevi le risposte pubblicate da quell’account, lette dalla sua scheda “Risposte” e ordinate dalla più recente.
- Il post di origine nella stessa rigain_reply_to contiene id, url, text, author e published_at del post a cui risponde ogni risposta, così puoi leggere ogni scambio direttamente dal risultato.
- ID della conversazione e del post padreconversation_id e in_reply_to_id collegano ogni risposta al suo thread e al post esatto che la precede, così puoi raggruppare le risposte per conversazione.
- Testo, media ed engagement della rispostaOgni risposta arriva con il suo testo, le eventuali immagini o i video allegati e i conteggi di Mi piace, commenti, condivisioni e visualizzazioni.
Parametri della X User Replies API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio | Il nome utente X di cui raccogliere le risposte, con o senza la @ iniziale. |
results_limit | Facoltativo | Quante risposte restituire, da 1 a 1.000. Il valore predefinito è 20. |
Come usare la X User Replies API
Invia un nome utente e leggi le sue risposte insieme ai post a cui rispondono.
- Invia con POST {"username": "elonmusk", "results_limit": 20} a /v1/x/user-replies.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi le risposte da results.items, con il post di origine in in_reply_to, e passa results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/x/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"elonmusk","results_limit":20}'
# in_reply_to holds the post each reply answers: its text, author, url and publish time.Casi d’uso della X User Replies API
- Mappare con chi parla un account: Conta in_reply_to.author.username tra le risposte di un account per elencare le persone e i brand con cui interagisce più spesso.
- Analizzare le risposte del servizio clienti di un brand: Leggi il text di ogni risposta accanto a in_reply_to.text e sottrai in_reply_to.published_at da published_at per misurare quanto rapidamente e quanto bene risponde un account di assistenza.
- Seguire cosa dice un personaggio pubblico nelle risposte: Raccogli a intervalli programmati le risposte di un dirigente o di un politico per cogliere le dichiarazioni fatte all’interno delle conversazioni, conservando url come link alla fonte.
- Creare coppie post-risposta per l’analisi: Abbina in_reply_to.text a text per costruire dataset di scambi utili a studiare il tono, la posizione o gli argomenti con cui risponde un account.
Consigli degli esperti per la X User Replies API
- Rimuovi gli @handle iniziali da text prima di misurare il sentiment o la lunghezza, perché una risposta si apre con l’handle dell’account a cui risponde.
- Raggruppa le risposte per conversation_id per vedere tutti i messaggi che l’account ha lasciato in un thread.
- Quando in_reply_to.text o il suo autore sono vuoti, conserva la risposta e salva in_reply_to.url per poter recuperare più tardi il post di origine.
- Usa X Post Replies API con gli URL dei post quando ti serve ciò che altre persone hanno risposto ai post dell’account; X User Replies API copre le risposte scritte dall’account.
API correlate
Oltre alla X User 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 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.
- X Thread Context API — Leggi un post con i messaggi precedenti della catena di risposte, le risposte pubbliche e gli ID delle relazioni.
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts 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
- Twitter Follow Checker API
- Twitter Video Transcript API