reddit/
user-posts

Collectez jusqu’à 1 000 publications soumises par un utilisateur Reddit à partir de son seul nom, triées par new, top ou hot, avec le titre et le corps, le score net, le nombre de commentaires et les médias.

Reddit User Posts API

Nom d’utilisateur en entrée
Tri new / top / hot
Jusqu’à 1 000 publications
Score et commentaires
0,5 crédit par résultat
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

Reddit User Posts

L’historique des publications d’un utilisateur Reddit rassemble tout ce qu’un compte a soumis dans les différentes communautés, chaque publication avec son titre et son corps, son lien, sa date, son score net, son nombre de commentaires et les images ou vidéos jointes. Parcouru par date ou par score, il révèle ce que partage une personne, lesquels de ses sujets prennent et comment sa production évolue, ce qui nourrit l’étude de créateurs, la veille sur le compte d’un fondateur et la collecte des textes de fond d’un expert.

Fonctionnalités de la Reddit User Posts API

  • Un nom d’utilisateur, jusqu’à 1 000 publicationsusername reçoit un seul compte, avec ou sans le préfixe u/, et results_limit collecte de 1 à 1 000 de ses publications, 25 par défaut.
  • Titre et corps dans un seul champtext commence par le titre de la publication puis, pour les publications texte, ajoute une ligne vide et le corps complet : un seul champ contient tout l’écrit.
  • Score net et nombre de commentairesmetrics.likes_count correspond au score de la publication, votes positifs moins votes négatifs, et metrics.comments_count montre l’ampleur de la discussion suscitée.
  • Images, galeries et vidéos hébergéesmedia liste chaque image ou vidéo jointe avec son url, son image d’aperçu et sa largeur et hauteur en pixels, prêtes pour des vignettes ou des téléchargements.

Paramètres de la Reddit User Posts API

ParamètresObligatoireDescription
usernameObligatoireUn nom d’utilisateur Reddit, avec ou sans le préfixe u/, composé de 3 à 20 lettres, chiffres, tirets ou traits de soulignement.
sort_byFacultatifOrdre des publications : new (par défaut), top ou hot.
results_limitFacultatifNombre maximal de publications à collecter, entier de 1 à 1 000 ; 25 par défaut.

Comment utiliser la Reddit User Posts API

Envoyez un nom d’utilisateur avec un ordre de tri et une limite, puis parcourez les publications page par page.

  1. Envoyez {"username": "spez", "sort_by": "new", "results_limit": 25} en POST à /v1/reddit/user-posts.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les publications dans results.items et, tant que has_more vaut true, transmettez results.next_cursor pour charger la page suivante.
curl -X POST "https://api.socq.ai/v1/reddit/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"spez","sort_by":"new","results_limit":25}'

Cas d’usage de la Reddit User Posts API

  • Suivre les dernières publications d’un compte : Lancez sort_by new à intervalles réguliers et lisez published_at et url pour repérer chaque nouvelle publication d’un fondateur, d’un journaliste ou d’un concurrent.
  • Classer les publications les mieux notées d’un utilisateur : Demandez sort_by top et comparez likes_count à comments_count pour voir quels sujets et formats d’une personne ont suscité le plus de réactions.
  • Constituer un corpus à partir des textes d’un expert : Conservez le text des publications texte avec leur url et published_at pour réunir un jeu de données des explications détaillées d’un spécialiste.

Conseils d’expert pour la Reddit User Posts API

  • Coupez text à la première ligne vide pour séparer le titre du corps ; les publications de lien et de média ne contiennent que leur titre.
  • Pour repérer les nouvelles publications d’un compte avec sort_by new, gardez les id déjà enregistrés et arrêtez la lecture des pages dès qu’un id connu apparaît.
  • Collectez le même nom avec Reddit User Comments API si vous avez besoin de toute l’activité du compte, car ses réponses dans les discussions des autres y sont renvoyées.

En complément de la Reddit User Posts API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Reddit.

  • Reddit Posts API — Collectez le texte des publications publiques, auteurs, contexte de la communauté, médias, horodatages et l’engagement visible à partir d’URL Reddit prises en charge.
  • Reddit Comments API — Collectez le texte des commentaires publics, auteurs, références à la publication et au commentaire parent, contexte de la communauté, horodatages et engagement visible à partir d’URL de publications prises en charge.
  • Reddit Subreddit Posts API — Repérez les publications publiques à partir d’URL de subreddits, avec tri par nouveautés, meilleures ou tendances, limite de résultats par subreddit et contexte normalisé de la communauté et de l’engagement.
  • Reddit User Profile API — Consultez des comptes Reddit par nom d’utilisateur, avec le karma total, de publication et de commentaire, les compteurs d’activité, l’âge du compte et les indicateurs du profil.
  • Reddit User Active Subreddits API — Listez les subreddits dans lesquels un utilisateur Reddit est actif à partir de son nom, avec le nombre de membres et la description de chacun.
  • Reddit Popular Feed API — Collectez les publications de r/popular dans l’ordre hot, best, new, rising ou top, avec titre et corps, auteur, score, commentaires et médias.

Explorer d’autres plateformes

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

Reddit User Posts API — FAQ

Reddit User Posts API est une interface programmatique qui collecte les publications soumises par un compte Reddit à partir de son nom d’utilisateur. Elle renvoie pour chaque publication le titre et le corps, le lien, la date de publication, le score, le nombre de commentaires et les médias joints.

Envoyez le nom d’utilisateur avec sort_by à new et un results_limit allant jusqu’à 1 000, puis parcourez les résultats avec next_cursor jusqu’à ce que has_more vaille false.

new liste les publications du compte de la plus récente à la plus ancienne, top les classe par score et hot suit le classement « hot » de Reddit pour le profil. Sans sort_by, c’est new qui s’applique.

Chaque publication renvoyée coûte 0,5 crédit : les 25 publications par défaut coûtent 12,5 crédits et 1 000 publications en coûtent 500. Un compte qui a moins de publications que results_limit n’est facturé que pour celles qui sont renvoyées.