truth-social/
user-posts

Saisissez un nom d’utilisateur public ou un user_id numérique pour récupérer les publications disponibles d’un compte, avec texte, auteur, médias, horodatages et données d’engagement normalisés.

Truth Social User Posts API

Nom d’utilisateur ou user_id
Publications publiques d’un compte
0,19 crédit/tâche
0,19 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
usernameObligatoire (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_idObligatoire (au moins un)ID de compte composé uniquement de chiffres. Il peut remplacer username ou être envoyé avec le nom d’utilisateur correspondant.
trimFacultatifBoolé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.

  1. 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.
  2. Envoyez cette entrée en POST à /v1/truth-social/user-posts et conservez data.task_id depuis la réponse.
  3. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. 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 success

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données Truth Social avec les données publiques d’autres plateformes sociales prises en charge.

Truth Social User Posts API — FAQ

Truth Social User Posts API récupère les publications publiques d’un compte à partir de son nom d’utilisateur ou de son user_id numérique, et renvoie texte, auteur, médias, horodatages et données d’engagement visibles sous forme normalisée.

Au moins un des deux est obligatoire. Utilisez username dans la plupart des cas, ou user_id si vous disposez déjà de l’ID numérique du compte.

Oui, mais les deux valeurs sont transmises à la collecte : elles doivent donc désigner le même compte.

trim est un booléen facultatif. Ne le définissez que si vous devez choisir explicitement true ou false ; sinon, vous pouvez l’omettre.

Non. Chaque tâche effectue une seule collecte à la source. next_cursor ne pagine que les enregistrements déjà sauvegardés pour cette tâche.

Chaque tâche réussie coûte un forfait de 0,19 crédit, quel que soit le nombre de publications renvoyées.