reddit/
subreddit-posts

Découvrez les publications Reddit publiques d’URL de subreddits triées par récentes, mieux notées ou tendance, avec contenu, auteurs, contexte de communauté, médias et engagement visible en enregistrements normalisés.

Reddit Subreddit Posts API

Entrée par URL de subreddit
Récentes, mieux notées ou tendance
Limite par subreddit
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 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ètresObligatoireDescription
urlsObligatoireListe obligatoire d’URL de subreddits Reddit publics utilisant le chemin exact /r/{subreddit} sur un hôte Reddit pris en charge.
results_limitFacultatifNombre maximal de publications demandées pour chaque URL de subreddit ; vaut 100 par défaut et accepte les entiers de 1 à 2 000.
sort_byFacultatifListe 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.

  1. Préparez une ou plusieurs URL Reddit publiques dont le chemin est /r/{subreddit}.
  2. Envoyez urls, results_limit et sort_by en POST à /v1/reddit/subreddit-posts, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à la réussite de la tâche ou un échec.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

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

Reddit Subreddit Posts API — FAQ

Reddit Subreddit Posts API découvre les publications publiques d’URL de subreddits acceptées, avec un tri par récentes, mieux notées ou tendance. Elle renvoie le contenu normalisé, les auteurs, le contexte de communauté, les médias, les horodatages et l’engagement visible.

Envoyez une URL http ou https sur un hôte Reddit pris en charge dont le chemin est exactement /r/{subreddit}, avec une barre oblique finale facultative. Les noms de subreddits, les URL de publications et les chemins plus profonds ne sont pas acceptés.

sort_by accepte new, top et hot, et vaut new par défaut. La requête n’accepte aucun paramètre de période pour les listes top.

results_limit vaut 100 par défaut et accepte les valeurs de 1 à 2 000. Il s’applique séparément à chaque URL : deux URL avec un results_limit de 50 demandent donc jusqu’à 100 publications.

Non. Chaque publication peut contenir comments_count, mais le résultat ne comprend ni le texte des commentaires ni leurs auteurs.

Les détails de l’auteur, les médias, le flair, le contexte de communauté, la date de publication et les valeurs d’engagement peuvent être null ou vides lorsque la liste publique n’expose aucune valeur exploitable.

Chaque enregistrement de publication renvoyé coûte 0,5 crédit SocQ. L’estimation avant requête multiplie urls par results_limit, et un jeu de résultats vide n’entraîne aucun frais de résultat.