reddit/
popular-feed

Collectez les publications qui montent sur le fil r/popular de Reddit dans l’un de ses cinq ordres de tri, avec titre et corps, auteur, score, nombre de commentaires et médias, jusqu’à 500 par requête.

Reddit Popular Feed API

Aucune entrée requise
Cinq ordres de tri
Période pour top
Jusqu’à 500 publications
0,5 crédit par résultat
Prêt
README

Par SocQ · Mis à jour le

Reddit Popular Feed

Le fil populaire de Reddit, r/popular, est le flux des publications qui grimpent en même temps dans toutes les communautés du site, chacune avec son titre et son corps, son auteur, son score, son nombre de commentaires, sa date de publication et les images ou vidéos jointes. Lu selon différents ordres de tri et périodes, il montre quels sujets, formats et histoires percent à l’échelle de toute la plateforme, ce qui sert à repérer tôt l’actualité, à étudier les formats de contenu et à prendre le pouls des conversations sur Reddit.

Fonctionnalités de la Reddit Popular Feed API

  • Cinq façons d’ordonner r/popularsort_by lit le fil en best, hot, new, rising ou top, et hot s’applique lorsque le champ est omis.
  • Une période pour l’ordre toppublished_within restreint top à la dernière heure, au jour, à la semaine, au mois, à l’année ou à toute la période, avec day par défaut.
  • Des publications complètes avec auteur et médiasChaque ligne contient text avec le titre et le corps, l’url de la publication, le nom d’utilisateur et le lien de profil de l’auteur, le score dans likes_count, comments_count et media avec ses dimensions en pixels.

Paramètres de la Reddit Popular Feed API

ParamètresObligatoireDescription
sort_byFacultatifOrdre de r/popular : best, hot (par défaut), new, rising ou top.
published_withinFacultatifPériode appliquée lorsque sort_by vaut top : hour, day (par défaut), week, month, year ou all.
results_limitFacultatifNombre maximal de publications à collecter, entier de 1 à 500 ; 25 par défaut.

Comment utiliser la Reddit Popular Feed API

Choisissez un ordre de tri et une limite, ou envoyez un corps vide, puis parcourez le fil page par page.

  1. Envoyez {"sort_by": "hot", "results_limit": 25} en POST à /v1/reddit/popular-feed.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les publications dans results.items et chargez les pages suivantes avec results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sort_by":"hot","results_limit":25}'

Cas d’usage de la Reddit Popular Feed API

  • Repérer les sujets avant leur pic : Interrogez régulièrement sort_by rising ou new et surveillez published_at, likes_count et comments_count pour voir quelles publications prennent de la vitesse sur r/popular.
  • Récapitulatif hebdomadaire des publications phares : Demandez sort_by top avec published_within week et listez l’url, le text et le score de ce qui a percé au cours des sept derniers jours.
  • Étudier les formats qui atteignent r/popular : Classez les publications selon leur type de média, image, vidéo ou texte seul, puis comparez likes_count et comments_count d’un groupe à l’autre.

Conseils d’expert pour la Reddit Popular Feed API

  • Réglez sort_by sur top chaque fois que vous utilisez published_within, car la période ne s’applique qu’à l’ordre top.
  • Enregistrez collected_at avec chaque instantané et dédoublonnez sur id, car une même publication peut apparaître dans des collectes successives d’un fil qui bouge vite.
  • Envoyez author.username à Reddit User Profile API lorsqu’un auteur revient souvent, pour vérifier son karma et l’âge de son compte.

En complément de la Reddit Popular Feed 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 Search API — Recherchez des publications Reddit publiques par requête textuelle et période de publication, avec contenu, auteurs, contexte de la communauté, horodatages, médias et engagement visible normalisés.
  • Reddit User Posts API — Collectez l’historique des publications d’un utilisateur Reddit à partir de son nom, trié par new, top ou hot, avec titre et corps, score, commentaires et médias.
  • Reddit Trending Searches API — Obtenez sans aucune entrée les recherches en tendance aujourd’hui sur Reddit, chacune avec son rang et un lien vers les résultats de Reddit.

Explorer d’autres plateformes

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

Reddit Popular Feed API — FAQ

Reddit Popular Feed API est une interface programmatique qui collecte les publications du fil r/popular de Reddit selon l’ordre de tri et la période de votre choix. Elle renvoie pour chaque publication le titre et le corps, le lien, l’auteur, le score, le nombre de commentaires et les médias.

Tous les champs sont facultatifs : une requête vide renvoie les 25 publications les plus « hot » de r/popular, tandis que sort_by, published_within et results_limit ajustent l’ordre, la période et le nombre.

results_limit accepte de 1 à 500 publications par requête et chaque publication coûte 0,5 crédit : les 25 publications par défaut coûtent 12,5 crédits et 500 publications en coûtent 250.