Truth Social Profile
Truth Social Profile cerca un account pubblico noto. Invia un nome utente per ricevere un record normalizzato dell’account, utilizzabile direttamente per l’arricchimento, la revisione e le istantanee programmate dei profili.
Funzionalità della Truth Social Profile API
- Ricerca per nome utente esattoInterroga un nome utente pubblico noto per attività, senza ricerca approssimativa degli account né URL dei profili.
- Identità dell’account coerenteRicevi ID dell’account, nome utente, nome visualizzato, URL pubblico del profilo, biografia e orario di raccolta in campi fissi.
- Dettagli del profiloRecupera avatar, immagine di copertina, sito web, posizione, stato di verifica e stato di privacy quando sono pubblicamente disponibili.
- Istantanea delle metriche visibiliRegistra i conteggi di follower, seguiti e post osservati al momento della raccolta per confronti successivi.
Parametri della Truth Social Profile API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio | Nome utente pubblico obbligatorio composto da 1–64 lettere ASCII, cifre, punti, trattini bassi o trattini. La convalida consente una @ iniziale, ma si consiglia il nome utente canonico senza @. Gli URL dei profili non sono accettati. |
Come usare la Truth Social Profile API
Invia un nome utente pubblico, salva l’ID attività e leggi il risultato dell’account al termine.
- Inserisci un nome utente noto di Truth Social, come realDonaldTrump. Per una risoluzione affidabile, usa il nome utente senza @ iniziale.
- Invia con POST username a /v1/truth-social/profile e salva data.task_id dalla risposta.
- Interroga GET /v1/tasks/{task_id} finché data.status diventa succeeded o failed.
- Dopo il successo, leggi il record normalizzato dell’account da data.results.items.
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"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successCasi d’uso della Truth Social Profile API
- Arricchimento degli account: Aggiungi identità pubblica, biografia, immagini del profilo, sito web e metriche visibili a un record che ha già un nome utente.
- Revisione degli account: Converti i profili pubblici in campi coerenti per la revisione interna, la classificazione e l’ispezione manuale.
- Monitoraggio delle modifiche ai profili: Salva istantanee programmate e confronta biografia, immagini, stato e metriche usando collected_at.
Consigli degli esperti per la Truth Social Profile API
- Salva il nome utente canonico senza @ per evitare più forme dello stesso account.
- Una sintassi valida non garantisce che un account esista, sia pubblico o sia accessibile al momento.
- Tratta immagini del profilo, sito web, posizione, stato e metriche come campi nullable della fonte.
- Questo endpoint restituisce solo i dettagli dell’account. Usa Truth Social User Posts API per i post pubblici.
- Non inviare results_limit né un cursore della fonte; ogni attività esegue una sola ricerca di account.
API correlate
Oltre alla Truth Social Profile 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 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.