Truth Social User Posts
Truth Social User Posts récupère les publications d’un compte public connu. Chaque tâche désigne le compte par son nom d’utilisateur ou son user_id numérique, effectue une seule requête de collecte et renvoie des enregistrements de publications homogènes.
Fonctionnalités de la Truth Social User Posts API
- Deux identifiants de compte possiblesUtilisez un nom d’utilisateur public ou un user_id composé uniquement de chiffres. Au moins un des deux identifiants est obligatoire.
- Un seul lot par tâcheChaque tâche effectue une collecte unique de publications du compte et renvoie les publications publiques présentes dans cette réponse, sans aller chercher les pages suivantes de la source.
- Contenu de publication normaliséRecevez l’ID de la publication, l’URL, le texte, l’auteur, les dates de publication et de collecte, les médias, les hashtags et les mentions dans des champs fixes.
- Engagement visibleConserve les nombres disponibles de mentions « J’aime », de commentaires, de partages et de vues, en laissant à null les valeurs indisponibles.
Paramètres de la Truth Social User Posts API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire (au moins un) | Nom d’utilisateur public, avec un @ initial facultatif, suivi de 1–64 lettres ASCII, chiffres, points, tirets bas ou traits d’union. Les espaces en début ou en fin de valeur et les URL de profil ne sont pas acceptés. |
user_id | Obligatoire (au moins un) | ID de compte composé uniquement de chiffres. Il peut remplacer username ou être envoyé avec le nom d’utilisateur correspondant. |
trim | Facultatif | Booléen facultatif. Envoyez true ou false lorsque vous devez définir l’option explicitement ; omettez le champ si vous ne voulez pas l’envoyer. |
Comment utiliser la Truth Social User Posts API
Fournissez un nom d’utilisateur ou un user_id, conservez l’ID de la tâche et lisez la liste de publications une fois la tâche réussie.
- Saisissez un nom d’utilisateur public ou un user_id composé uniquement de chiffres. Dans la plupart des cas, ne fournissez qu’un seul identifiant.
- Envoyez cette entrée en POST à /v1/truth-social/user-posts 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 data.results.items. Ne suivez next_cursor que si has_more vaut true, pour les résultats déjà stockés.
curl -X POST "https://api.socq.ai/v1/truth-social/user-posts" \
-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 User Posts API
- Instantanés du contenu d’un compte : Sauvegardez les publications publiques actuellement disponibles pour l’archivage, la revue ou une comparaison planifiée.
- Analyse de contenu : Classez, recherchez et traitez les publications grâce à des champs homogènes de texte, d’auteur, de média et d’horodatage.
- Observation de l’engagement : Comparez les mentions « J’aime », commentaires, partages et vues visibles en prenant collected_at comme heure d’observation.
Conseils d’expert pour la Truth Social User Posts API
- Privilégiez un nom d’utilisateur vérifié. Si le résultat d’un autre compte fournit un author.id numérique, vous pouvez le réutiliser comme user_id.
- Ne placez pas d’URL de profil dans username ni dans user_id.
- Si vous fournissez les deux identifiants, vérifiez qu’ils désignent le même compte, car les deux valeurs sont transmises.
- Cet endpoint n’accepte ni results_limit ni curseur source ; chaque tâche ne collecte qu’une fois.
- next_cursor ne fait avancer que dans les résultats de tâche sauvegardés et ne collecte pas d’autres publications à la source.
API associées
En complément de la Truth Social User Posts 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 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.