Retour aux API
Données publiques Truth Social

Truth Social APIs

Récupérez les détails d’un compte public, collectez une page source de publications d’un compte ou transformez l’URL d’une publication connue en enregistrements normalisés.

API Truth Social disponibles

Utilisez Profile pour un nom d’utilisateur, User Posts pour un nom d’utilisateur ou un ID de compte numérique, et Post pour l’URL truthsocial.com d’une publication connue.

Quelles données Truth Social pouvez-vous récupérer ?

Les résultats suivent des schémas stables de comptes et de publications, tandis que les champs dépendant de la source restent nullables.

Identité du profil

Lisez le nom d’utilisateur, le nom affiché, la biographie, les médias du profil, le site web, les indicateurs de compte, la localisation et les nombres visibles, lorsqu’ils sont disponibles.

Contenu des publications

Récupérez l’identité normalisée de la publication, son URL publique, son texte, le contexte de l’auteur, la date de publication et la date de collecte.

Médias et engagement

Exploitez les pièces jointes, hashtags, mentions et compteurs visibles de mentions « J’aime », de commentaires, de partages et de vues, lorsqu’ils sont disponibles.

Choisir une API Truth Social

Chaque endpoint a une entrée source bornée et partage le même flux de tâche asynchrone.

EndpointEntréePortée de la source
ProfileUn nom d’utilisateurUn compte public
User PostsNom d’utilisateur ou ID utilisateur numériqueUne page de réponse du fournisseur
PostUne URL truthsocial.comAu plus une publication publique

Fonctionnement de la collecte Truth Social

L’envoi et la lecture des résultats stockés sont deux étapes distinctes.

  1. 1. Choisir l’endpoint

    Sélectionnez Profile, User Posts ou Post selon la ressource publique que vous connaissez déjà.

  2. 2. Suivre la tâche

    Conservez le task_id et interrogez /v1/tasks/{task_id} jusqu’à la réussite ou l’échec.

  3. 3. Lire les enregistrements sauvegardés

    Après la réussite, lisez data.results.items et ne suivez next_cursor que si les résultats stockés comptent une autre page.

Collecter des données Truth Social publiques

Fournissez un sélecteur public valide et authentifiez-vous avec une clé API SocQ.

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"}'

Usages courants de l’API Truth Social

Enrichissement de comptes publics

Rattachez l’identité, la biographie, les images, les indicateurs et les nombres disponibles à un nom d’utilisateur public connu.

Instantanés des publications d’un compte

Stockez les enregistrements de publications exposés pour un compte choisi, à une date de collecte connue.

Revue d’une publication connue

Normalisez une publication publique avec son auteur, ses médias, ses horodatages et son engagement visible, lorsqu’ils sont disponibles.

Portée et limites

Ces endpoints lisent les données publiques disponibles au moment de la collecte et n’offrent aucune action de gestion de compte.

  • Profile exige un seul nom d’utilisateur respectant le motif avec @ facultatif.
  • User Posts exige username ou un user_id composé uniquement de chiffres ; si les deux sont fournis, les deux valeurs sont transmises, et trim est un booléen facultatif.
  • Post exige une URL non vide dont le nom d’hôte analysé est truthsocial.com ou l’un de ses sous-domaines.
  • Les requêtes n’acceptent ni results_limit ni curseur du fournisseur.
  • Le curseur et la limite de résultat paginent les enregistrements déjà stockés par SocQ, et ne vont pas chercher une autre page à la source.

FAQ de l’API Truth Social

Quelles API Truth Social sont disponibles ?

Profile récupère un compte public, User Posts collecte une page source pour un nom d’utilisateur ou un ID de compte numérique, et Post résout l’URL d’une publication publique connue.

User Posts peut-il accepter à la fois username et user_id ?

Oui. L’un des deux au moins est requis, et le backend transmet les deux valeurs non vides sans désigner de valeur prioritaire.

next_cursor collecte-t-il d’autres publications à la source ?

Non. Il ne fait qu’avancer dans les enregistrements déjà stockés une fois la tâche réussie.

Combien coûte la collecte ?

Chaque tâche Truth Social réussie est facturée un montant fixe de 0,19 crédit SocQ.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

Google Ad Library API

Découvrez des annonceurs publics, collectez les créations d’une entreprise ou récupérez par URL une création connue du Transparency Center, pour la recherche et la vérification.

Google Maps API

Découvrez des lieux publics, récupérez des détails normalisés à partir d’URL Maps connues et collectez des avis publics avec le contexte du lieu et de l’auteur relié à la source.

Amazon API

Recherchez des produits Amazon publics et collectez des détails de produits, Best Sellers, avis, profils de vendeurs et vitrines de créateurs normalisés sur les places de marché prises en charge.

Apple App Store API

Collectez les détails d’applications, les classements par catégorie et les avis publics de l’Apple App Store à partir d’URL connues de la boutique, sous forme d’enregistrements d’applications et d’avis normalisés.

SEO API

Interrogez en direct les résultats organiques de Google, comparez la demande et la difficulté de classement des mots-clés, développez des termes de départ, repérez les mots-clés et les pages qui assurent la visibilité d’un site dans la recherche, classez l’intention de recherche et collectez les résultats de Google News, Google Images, Google Autocomplete, Bing et YouTube. Chaque endpoint utilise la même clé API SocQ, le même flux de tâche asynchrone et le même format de résultat normalisé.

Telegram API

Lisez les chaînes Telegram publiques à partir de leurs liens t.me : profils de chaîne avec nombre d’abonnés, publications avec vues et réactions, publications isolées, commentaires des groupes de discussion, chaînes similaires et recherche dans tout l’historique.