Truth Social User Posts
Truth Social User Posts recupera i post di un account pubblico noto. Ogni attività identifica l’account tramite nome utente o user_id numerico, esegue una sola richiesta di raccolta e restituisce record di post coerenti.
Funzionalità della Truth Social User Posts API
- Due identificatori dell’accountUsa un nome utente pubblico o uno user_id composto solo da cifre. È richiesto almeno un identificatore.
- Un batch per attivitàOgni attività esegue una raccolta dei post di un account e restituisce i post pubblici disponibili in quella risposta, senza recuperare le pagine successive della fonte.
- Contenuto normalizzato dei postRicevi ID del post, URL, testo, autore, orari di pubblicazione e di raccolta, media, hashtag e menzioni in campi fissi.
- Engagement visibileConserva i conteggi disponibili di Mi piace, commenti, condivisioni e visualizzazioni, lasciando null i valori non disponibili.
Parametri della Truth Social User Posts API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio (almeno uno) | Nome utente pubblico con una @ iniziale facoltativa seguita da 1–64 lettere ASCII, cifre, punti, trattini bassi o trattini. Spazi iniziali o finali e URL dei profili non sono accettati. |
user_id | Obbligatorio (almeno uno) | ID dell’account composto solo da cifre. Può sostituire username oppure essere inviato insieme allo username corrispondente. |
trim | Facoltativo | Booleano facoltativo. Invia true o false quando devi impostare l’opzione in modo esplicito; ometti il campo se non vuoi inviarlo. |
Come usare la Truth Social User Posts API
Fornisci un nome utente o uno user_id, salva l’ID attività e leggi l’elenco dei post quando l’attività riesce.
- Inserisci un nome utente pubblico o uno user_id composto solo da cifre. Nella maggior parte dei casi, fornisci un solo identificatore.
- Invia con POST l’input a /v1/truth-social/user-posts e salva data.task_id dalla risposta.
- Interroga GET /v1/tasks/{task_id} finché l’attività riesce o fallisce.
- Dopo il successo, leggi data.results.items. Segui next_cursor solo quando has_more è true per i risultati salvati.
curl -X POST "https://api.socq.ai/v1/truth-social/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"realDonaldTrump"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successCasi d’uso della Truth Social User Posts API
- Istantanee dei contenuti degli account: Salva i post pubblici attualmente disponibili per archiviazione, revisione o confronto programmato.
- Analisi dei contenuti: Classifica, cerca ed elabora i post usando campi coerenti di testo, autore, media e timestamp.
- Osservazione dell’engagement: Confronta Mi piace, commenti, condivisioni e visualizzazioni visibili insieme a collected_at come orario di osservazione.
Consigli degli esperti per la Truth Social User Posts API
- Preferisci un nome utente verificato. Se il risultato di un altro account fornisce un author.id numerico, puoi riutilizzarlo come user_id.
- Non inserire l’URL di un profilo in username o user_id.
- Quando fornisci entrambi gli identificatori, assicurati che si riferiscano allo stesso account, perché entrambi i valori vengono inoltrati.
- Questo endpoint non accetta results_limit né un cursore della fonte; ogni attività esegue una sola raccolta.
- next_cursor avanza solo tra i risultati salvati dell’attività e non raccoglie altri post dalla fonte.
API correlate
Oltre alla Truth Social User Posts API, usa queste API quando ti serve un altro tipo di dati pubblici di Truth Social.
- Truth Social Post API — Trasforma l’URL di un post noto di Truth Social in contenuti, contesto dell’autore, media, date e campi di engagement visibile normalizzati, se disponibili.
- Truth Social Profile API — Recupera un profilo Truth Social pubblico per nome utente con identità, bio, media del profilo, flag dell’account, località, conteggi visibili e contesto della raccolta normalizzati.