Torna alle API
Dati pubblici di Truth Social

Truth Social APIs

Recupera i dettagli pubblici di un account, raccogli una pagina della fonte con i post di un account o risolvi l’URL di un post noto in record normalizzati.

API di Truth Social disponibili

Usa Profile per un nome utente, User Posts per un nome utente o un ID account numerico e Post per l’URL di un post noto di truthsocial.com.

Quali dati di Truth Social puoi recuperare?

I risultati usano schemi stabili per account e post, mentre i campi che dipendono dalla fonte restano nullable.

Identità del profilo

Leggi nome utente, nome visualizzato, biografia, media del profilo, sito web, flag dell’account, località e conteggi visibili, quando disponibili.

Contenuto dei post

Recupera identità normalizzata del post, URL pubblico, testo, contesto dell’autore, data di pubblicazione e momento della raccolta.

Media ed engagement

Usa gli allegati, gli hashtag, le menzioni e i contatori visibili di Mi piace, commenti, condivisioni e visualizzazioni, quando disponibili.

Scegli un’API di Truth Social

Ogni endpoint ha un input limitato dalla fonte e condivide lo stesso flusso di lavoro con attività asincrona.

EndpointInputAmbito della fonte
ProfileUn nome utenteUn account pubblico
User PostsNome utente o ID utente numericoUna pagina di risposta del provider
PostUn URL di truthsocial.comAl massimo un post pubblico

Come funziona la raccolta da Truth Social

L’invio e il recupero dei risultati archiviati sono fasi separate.

  1. 1. Scegli l’endpoint

    Seleziona Profile, User Posts o Post per la risorsa pubblica che già conosci.

  2. 2. Segui l’attività

    Salva il task_id e interroga /v1/tasks/{task_id} fino al successo o all’errore.

  3. 3. Leggi i record salvati

    Dopo il successo, leggi data.results.items e segui next_cursor solo finché i risultati archiviati hanno un’altra pagina.

Raccogli dati pubblici di Truth Social

Fornisci un selettore pubblico valido e autenticati con una chiave API di SocQ.

curl -X POST "https://api.socq.ai/v1/truth-social/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"realDonaldTrump"}'

Usi comuni dell’API di Truth Social

Arricchimento di account pubblici

Associa identità, biografia, immagini, flag e conteggi disponibili a un nome utente pubblico noto.

Istantanee dei post di un account

Salva i record dei post esposti da un account selezionato in un momento di raccolta noto.

Revisione di post noti

Normalizza un post pubblico con autore, media, date ed engagement visibile, quando disponibili.

Ambito e limiti

Questi endpoint leggono i dati pubblici disponibili durante la raccolta e non offrono azioni di gestione degli account.

  • Profile richiede un nome utente con il modello che prevede @ facoltativa.
  • User Posts richiede username oppure un user_id composto solo da cifre; se vengono forniti entrambi, entrambi i valori vengono inoltrati, e trim è un booleano facoltativo.
  • Post richiede un URL non vuoto il cui hostname analizzato sia truthsocial.com o un suo sottodominio.
  • Le richieste non accettano results_limit né un cursore del provider.
  • Il cursore e il limite dei risultati paginano i record già archiviati da SocQ, senza recuperare un’altra pagina dalla fonte.

FAQ sull’API di Truth Social

Quali API di Truth Social sono disponibili?

Profile recupera un account pubblico, User Posts raccoglie una pagina della fonte per un nome utente o un ID account numerico e Post risolve l’URL di un post pubblico noto.

User Posts può accettare sia username sia user_id?

Sì. Ne serve almeno uno, e il backend inoltra entrambi i valori non vuoti senza dichiararne uno prevalente.

next_cursor raccoglie altri post dalla fonte?

No. Fa avanzare solo tra i record già archiviati dopo il successo dell’attività.

Quanto costa la raccolta?

Ogni attività Truth Social completata con successo ha un costo fisso di 0,19 crediti SocQ.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.