Truth Social Post
Truth Social Post identifie une publication publique connue. Il suffit d’envoyer l’URL de la publication pour recevoir au plus un enregistrement normalisé, utile à l’enrichissement de liens, à la revue de contenu et aux instantanés d’engagement planifiés.
Fonctionnalités de la Truth Social Post API
- Recherche par URL exacteEnvoyez une URL de publication truthsocial.com publique par tâche, sans recherche par mot-clé.
- Contenu complet de la publicationRecevez l’ID de la publication, son URL publique, son texte, sa date de publication et l’heure de collecte.
- Contexte de l’auteur et des médiasConserve l’identité de l’auteur, l’avatar, le statut du compte, les médias, les hashtags et les mentions lorsqu’ils sont disponibles.
- Instantané de l’engagementEnregistre les nombres visibles de mentions « J’aime », de commentaires, de partages et de vues, en laissant à null les valeurs indisponibles.
Paramètres de la Truth Social Post API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL complète obligatoire d’une publication Truth Social publique. Le nom d’hôte analysé doit être truthsocial.com ou l’un de ses sous-domaines. Indiquez http ou https et un chemin de publication réel. |
Comment utiliser la Truth Social Post API
Envoyez l’URL d’une vraie publication publique, conservez l’ID de la tâche et lisez les détails de la publication une fois la tâche terminée.
- Gardez l’URL de publication publique par défaut ou remplacez-la par le lien complet de la publication Truth Social à récupérer.
- Envoyez url en POST à /v1/truth-social/post et conservez data.task_id depuis la réponse.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- Après un succès, lisez l’enregistrement normalisé de la publication dans 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 successCas d’usage de la Truth Social Post API
- Enrichissement d’un lien de publication : Transformez le lien d’une publication connue en champs de texte, d’auteur, d’horodatage et de source exploitables en recherche.
- Revue d’un contenu ciblé : Récupérez le texte, l’auteur et les pièces jointes d’une publication publique précise dans un processus de revue.
- Suivi de l’évolution de l’engagement : Répétez la recherche à intervalle régulier et comparez l’engagement public à l’aide de collected_at.
Conseils d’expert pour la Truth Social Post API
- Envoyez l’URL complète d’une vraie publication, et non celle d’un profil, d’une page de recherche ou d’une autre page de Truth Social.
- L’URL doit comporter http ou https et utiliser truthsocial.com ou l’un de ses sous-domaines.
- Une URL qui passe la validation ne garantit pas que la publication existe ni qu’elle reste accessible au public.
- Considérez les détails de l’auteur, les médias, les hashtags, les mentions et les données d’engagement comme des champs nullables.
- Cet endpoint n’accepte ni results_limit ni curseur source, et renvoie au plus un enregistrement de publication par tâche.
API associées
En complément de la Truth Social Post API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Truth Social.
- Truth Social Profile API — Récupérez un profil Truth Social public par nom d’utilisateur, avec identité, biographie, médias du profil, indicateurs de compte, localisation, nombres visibles et contexte de collecte 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.