Truth Social Post
Truth Social Post risolve un singolo post pubblico noto. Invia l’URL del post per ricevere al massimo un record normalizzato, utile per arricchire i link, rivedere i contenuti e creare istantanee programmate dell’engagement.
Funzionalità della Truth Social Post API
- Ricerca per URL esattoInvia un URL di post pubblico di truthsocial.com per attività, senza ricerca per parola chiave.
- Contenuto completo del postRicevi ID del post, URL pubblico, testo, ora di pubblicazione e orario di raccolta.
- Contesto di autore e mediaConserva l’identità dell’autore, l’avatar, lo stato dell’account, i media, gli hashtag e le menzioni disponibili.
- Istantanea dell’engagementRegistra i conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni, lasciando null i valori non disponibili.
Parametri della Truth Social Post API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL completo obbligatorio di un post pubblico di Truth Social. L’hostname analizzato deve essere truthsocial.com o un suo sottodominio. Includi http o https e invia un percorso reale di post. |
Come usare la Truth Social Post API
Invia l’URL di un post pubblico reale, salva l’ID attività e leggi i dettagli del post al termine.
- Usa l’URL del post pubblico predefinito oppure sostituiscilo con il link completo del post di Truth Social che vuoi recuperare.
- Invia con POST url a /v1/truth-social/post e salva data.task_id dalla risposta.
- Interroga GET /v1/tasks/{task_id} finché l’attività riesce o fallisce.
- Dopo il successo, leggi il record normalizzato del post da data.results.items.
curl -X POST "https://api.socq.ai/v1/truth-social/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://truthsocial.com/@realDonaldTrump/117091934703272898"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successCasi d’uso della Truth Social Post API
- Arricchimento dei link ai post: Converti il link di un post noto in campi ricercabili di testo, autore, timestamp e origine.
- Revisione di contenuti selezionati: Recupera testo, autore e allegati di uno specifico post pubblico in un flusso di revisione.
- Monitoraggio delle variazioni di engagement: Ripeti la ricerca a intervalli programmati e confronta l’engagement pubblico insieme a collected_at.
Consigli degli esperti per la Truth Social Post API
- Invia l’URL completo di un post reale, non di un profilo, di una pagina di ricerca o di un’altra pagina di Truth Social.
- L’URL deve includere http o https e usare truthsocial.com o uno dei suoi sottodomini.
- Superare la convalida dell’URL non garantisce che il post esista o resti accessibile pubblicamente.
- Tratta i dettagli dell’autore, i media, gli hashtag, le menzioni e i dati di engagement come campi nullable.
- Questo endpoint non accetta results_limit né un cursore della fonte e restituisce al massimo un record di post per attività.
API correlate
Oltre alla Truth Social Post API, usa queste API quando ti serve un altro tipo di dati pubblici di Truth Social.
- 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.
- Truth Social User Posts API — Raccoglie una pagina di origine di post pubblici di Truth Social per nome utente o ID numerico dell’account con contenuti, autori, media, date ed engagement visibile normalizzati.