truth-social/
user-posts

Inserisci un nome utente pubblico o un user_id numerico per recuperare i post disponibili di un account con testo normalizzato, autore, media, timestamp e dati di engagement.

Truth Social User Posts API

Nome utente o user_id
Post pubblici dell’account
0,19 crediti/attività
0,19 crediti per richiesta
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

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

ParametriObbligatorioDescrizione
usernameObbligatorio (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_idObbligatorio (almeno uno)ID dell’account composto solo da cifre. Può sostituire username oppure essere inviato insieme allo username corrispondente.
trimFacoltativoBooleano 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.

  1. Inserisci un nome utente pubblico o uno user_id composto solo da cifre. Nella maggior parte dei casi, fornisci un solo identificatore.
  2. Invia con POST l’input a /v1/truth-social/user-posts e salva data.task_id dalla risposta.
  3. Interroga GET /v1/tasks/{task_id} finché l’attività riesce o fallisce.
  4. 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 success

Casi 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.

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.

Esplora altre piattaforme

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

Truth Social User Posts API — FAQ

Truth Social User Posts API recupera i post pubblici di un account tramite nome utente o user_id numerico e restituisce testo normalizzato, autore, media, timestamp e dati di engagement visibili.

Ne serve almeno uno. Nella maggior parte dei casi usa username, oppure usa user_id quando hai già l’ID numerico dell’account.

Sì, ma entrambi i valori vengono inoltrati alla raccolta, quindi devono identificare lo stesso account.

trim è un booleano facoltativo. Impostalo solo quando devi scegliere esplicitamente true o false; altrimenti può essere omesso.

No. Ogni attività esegue una sola raccolta dalla fonte. next_cursor pagina solo i record già salvati per quell’attività.

Ogni attività riuscita costa 0,19 crediti fissi, indipendentemente dal numero di post restituiti.