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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array 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_limit | Facoltativo | Numero massimo di risposte richieste per ogni post padre. Il valore predefinito è 100 e sono accettati multipli di 20 da 20 a 2.000. |
sort_by | Facoltativo | Ordinamento 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.
- 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.
- 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.
- Conserva il task_id restituito e interroga GET /v1/tasks/{task_id} mentre l’attività è queued, running o retrying.
- 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 trueCasi 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.
API correlate
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.
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context 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