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.
| Endpoint | Input | Ambito della fonte |
|---|---|---|
| Profile | Un nome utente | Un account pubblico |
| User Posts | Nome utente o ID utente numerico | Una pagina di risposta del provider |
| Post | Un URL di truthsocial.com | Al massimo un post pubblico |
Come funziona la raccolta da Truth Social
L’invio e il recupero dei risultati archiviati sono fasi separate.
1. Scegli l’endpoint
Seleziona Profile, User Posts o Post per la risorsa pubblica che già conosci.
2. Segui l’attività
Salva il task_id e interroga /v1/tasks/{task_id} fino al successo o all’errore.
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.
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.
Combina i dati di più piattaforme per analisi di business più complete
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.
Google Ad Library API
Trova gli inserzionisti pubblici, raccogli le creatività di un’azienda o recupera per URL una creatività nota del Transparency Center, per ricerca e verifica.
Google Maps API
Trova i luoghi pubblici, recupera dettagli normalizzati da URL noti di Maps e raccogli le recensioni pubbliche con il contesto di luogo e autore collegato alla fonte.
Amazon API
Cerca i prodotti pubblici di Amazon e raccogli dettagli dei prodotti, Best Sellers, recensioni, profili dei venditori e vetrine dei creator normalizzati dai marketplace supportati.
Apple App Store API
Raccogli dettagli delle app, classifiche per categoria e recensioni pubblici di Apple App Store da URL noti dello store, come record normalizzati di app e recensioni.
SEO API
Interroga in tempo reale i risultati organici di Google, confronta domanda delle parole chiave e difficoltà di posizionamento, espandi i termini di partenza, scopri le parole chiave e le pagine che determinano la visibilità di un sito nelle ricerche, classifica l’intento di ricerca e raccogli i risultati di Google News, Google Images, Google Autocomplete, Bing e YouTube. Ogni endpoint usa la stessa chiave API di SocQ, lo stesso flusso di attività asincrono e lo stesso formato di risultati normalizzato.
Telegram API
Leggi i canali Telegram pubblici dai loro link t.me: profili dei canali con iscritti, post con visualizzazioni e reazioni, singoli post, commenti dei gruppi di discussione, canali simili e ricerca in tutto lo storico.


