Reddit Subreddit Posts
Les publications d’un subreddit sont des contributions publiques à une communauté, avec titres, corps de texte, auteurs, flairs, médias, dates de publication et signaux visibles de votes et de commentaires. Ces champs de contenu, de contexte et d’engagement servent à surveiller une communauté, à étudier des sujets et à comparer des listes de subreddits sur des bases alignées.
Fonctionnalités de la Reddit Subreddit Posts API
- Découverte à partir d’une liste de subredditDécouvrez les publications publiques d’URL /r/{subreddit} acceptées, en choisissant la liste des récentes, des mieux notées ou des tendance pour tous les subreddits de la requête.
- Profondeur de collecte par subredditAppliquez results_limit séparément à chaque URL de subreddit envoyée, avec une valeur par défaut de 100 et une plage acceptée de 1 à 2 000.
- Contenu et auteurs de publications normalisésRenvoie les identifiants de publications, les URL de source, les titres, le corps de texte, les champs d’auteur disponibles et les références média dans une structure d’enregistrement homogène.
- Contexte de communauté et d’engagementConserve avec chaque publication le flair, les détails de la communauté, les dates de publication et de collecte, upvotes_count, comments_count, upvote_ratio et discovery_input.
Paramètres de la Reddit Subreddit Posts API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire d’URL de subreddits Reddit publics utilisant le chemin exact /r/{subreddit} sur un hôte Reddit pris en charge. |
results_limit | Facultatif | Nombre maximal de publications demandées pour chaque URL de subreddit ; vaut 100 par défaut et accepte les entiers de 1 à 2 000. |
sort_by | Facultatif | Liste appliquée à chaque URL de subreddit envoyée ; vaut new par défaut et accepte new, top ou hot. |
Comment utiliser la Reddit Subreddit Posts API
Envoyez des URL de subreddits publics avec un mode de liste et une limite de résultats par subreddit, puis lisez les résultats de la tâche asynchrone grâce à la pagination par curseur.
- Préparez une ou plusieurs URL Reddit publiques dont le chemin est /r/{subreddit}.
- Envoyez urls, results_limit et sort_by en POST à /v1/reddit/subreddit-posts, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à la réussite de la tâche ou un échec.
- Lisez data.results.items et demandez le next_cursor renvoyé tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/learnpython/"],"results_limit":100,"sort_by":"new"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Reddit Subreddit Posts API
- Veille sur les publications d’une communauté : Collectez la liste des récentes et gardez les ID, created_at, collected_at, titres et textes pour passer en revue les dernières contributions publiques de subreddits choisis.
- Étude thématique d’un subreddit : Regroupez titres, corps de texte, flairs et champs de communauté pour repérer les sujets et formats récurrents au sein de communautés publiques définies.
- Comparaison de listes alignées : Appliquez le même sort_by à toutes les URL de subreddits et comparez dates de publication, upvotes_count, comments_count et upvote_ratio dans un seul mode de liste.
Conseils d’expert pour la Reddit Subreddit Posts API
- Envoyez l’URL canonique de la page d’accueil /r/{subreddit} plutôt qu’un nom de subreddit, une URL de publication ou un chemin plus profond, afin que la requête passe la validation des URL.
- Calculez la profondeur demandée en multipliant le nombre d’urls par results_limit, car la limite et l’estimation de crédits s’appliquent séparément à chaque subreddit.
- Lancez des tâches distinctes pour comparer new, top et hot, car une seule valeur de sort_by s’applique à toutes les URL de subreddits d’une requête.
- Conservez discovery_input et collected_at avec chaque enregistrement, pour que vos jeux de données en aval gardent le subreddit source et l’heure d’observation.
- Prévoyez que les champs d’auteur, de médias, de flair, de communauté, d’horodatage et d’engagement soient null ou vides lorsqu’une liste publique ne les expose pas.
API associées
En complément de la Reddit Subreddit 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 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 Subreddit Details API
- 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 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.