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ètres | Obligatoire | Description |
|---|---|---|
sort_by | Facultatif | Ordre de r/popular : best, hot (par défaut), new, rising ou top. |
published_within | Facultatif | Période appliquée lorsque sort_by vaut top : hour, day (par défaut), week, month, year ou all. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"sort_by": "hot", "results_limit": 25} en POST à /v1/reddit/popular-feed.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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.
API associées
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.