Truth Social Profile
Truth Social Profile interroge un compte public connu. Envoyez un nom d’utilisateur pour recevoir un enregistrement de compte normalisé, directement exploitable pour l’enrichissement, la revue et les instantanés de profil planifiés.
Fonctionnalités de la Truth Social Profile API
- Recherche par nom d’utilisateur exactInterrogez un nom d’utilisateur public connu par tâche, sans recherche approximative de comptes ni URL de profil.
- Identité de compte cohérenteRecevez l’ID du compte, le nom d’utilisateur, le nom affiché, l’URL publique du profil, la biographie et l’heure de collecte dans des champs fixes.
- Détails du profilRécupérez avatar, image de couverture, site web, localisation, statut de vérification et statut de confidentialité lorsqu’ils sont publics.
- Instantané des métriques visiblesEnregistre les nombres d’abonnés, d’abonnements et de publications observés au moment de la collecte, pour les comparer plus tard.
Paramètres de la Truth Social Profile API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Nom d’utilisateur public obligatoire, de 1–64 lettres ASCII, chiffres, points, tirets bas ou traits d’union. La validation tolère un seul @ initial, mais le nom canonique sans @ est recommandé. Les URL de profil ne sont pas acceptées. |
Comment utiliser la Truth Social Profile API
Envoyez un nom d’utilisateur public, conservez l’ID de la tâche et lisez le résultat du compte une fois la tâche terminée.
- Saisissez un nom d’utilisateur Truth Social connu, par exemple realDonaldTrump. Pour une résolution fiable, utilisez-le sans @ initial.
- Envoyez username en POST à /v1/truth-social/profile et conservez data.task_id depuis la réponse.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que data.status vaille succeeded ou failed.
- Après un succès, lisez l’enregistrement normalisé du compte dans 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 successCas d’usage de la Truth Social Profile API
- Enrichissement de comptes : Ajoutez identité publique, biographie, images de profil, site web et métriques visibles à une fiche qui contient déjà un nom d’utilisateur.
- Revue de comptes : Transformez des profils publics en champs homogènes pour la revue interne, la classification et l’inspection manuelle.
- Suivi des changements de profil : Sauvegardez des instantanés planifiés et comparez biographie, visuels, statut et métriques grâce à collected_at.
Conseils d’expert pour la Truth Social Profile API
- Stockez le nom d’utilisateur canonique sans @ pour éviter plusieurs graphies d’un même compte.
- Une syntaxe valide ne garantit pas que le compte existe, qu’il est public ni qu’il est accessible à l’instant T.
- Considérez les images de profil, le site web, la localisation, le statut et les métriques comme des champs sources nullables.
- Cet endpoint ne renvoie que les détails du compte. Pour les publications publiques, utilisez Truth Social User Posts API.
- N’envoyez ni results_limit ni curseur source : chaque tâche effectue une seule recherche de compte.
API associées
En complément de la Truth Social Profile API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Truth Social.
- Truth Social Post API — Transformez l’URL d’une publication Truth Social connue en contenu, contexte de l’auteur, médias, horodatages et champs d’engagement visible disponibles, normalisés.
- Truth Social User Posts API — Collectez une page source de publications Truth Social publiques par nom d’utilisateur ou ID numérique de compte, avec contenu, auteurs, médias, horodatages et engagement visible normalisés.