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ètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Un nom d’utilisateur Reddit, avec ou sans le préfixe u/, composé de 3 à 20 lettres, chiffres, tirets ou traits de soulignement. |
sort_by | Facultatif | Ordre des publications : new (par défaut), top ou hot. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"username": "spez", "sort_by": "new", "results_limit": 25} en POST à /v1/reddit/user-posts.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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.
API associé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.