reddit/
subreddit-search

Recherchez des discussions et des publications publiques au sein d’un subreddit précis, par requête, période et ordre de tri.

Reddit Subreddit Search API

Recherche dans une communauté
Découverte ciblée de publications
Discussions de subreddit
0,6 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 Search

Chercher dans un subreddit désigné permet d’isoler les conversations pertinentes du bruit général de la plateforme. Ces recherches circonscrites à une communauté renvoient des titres de publications, des textes, des pseudos d’auteurs, des nombres de commentaires, des votes positifs et des liens média, le tout normalisé.

Fonctionnalités de la Reddit Subreddit Search API

  • Requête limitée à une communautéRestreignez les recherches par mot-clé à des communautés /r/{subreddit} précises au lieu d’interroger toute la plateforme.
  • Options de tri détailléesTriez les publications trouvées par pertinence, popularité, meilleures notes, récence ou nombre de commentaires, selon les besoins de votre étude.
  • Filtres de période souplesFiltrez les résultats par fenêtre de publication : heure, jour, semaine, mois, année, ou sur toute la durée.
  • Détails complets des publicationsRecevez des enregistrements normalisés avec le titre, le corps, l’auteur, le nombre de votes positifs, le nombre de commentaires et les liens permanents.

Paramètres de la Reddit Subreddit Search API

ParamètresObligatoireDescription
queryObligatoireMot-clé de recherche à exécuter dans la communauté de subreddit indiquée.
urlsObligatoireTableau d’URL Reddit publiques /r/{subreddit} qui délimitent la communauté dans laquelle chercher.
results_limitFacultatifNombre maximal de publications renvoyées par communauté ; vaut 100 par défaut, avec une plage autorisée de 1 à 2 000.
sort_byFacultatifMode de tri des publications trouvées : relevance (par défaut), hot, top, new ou comments.
published_withinFacultatifFiltre de période de publication : all (par défaut), year, month, week, day ou hour.

Comment utiliser la Reddit Subreddit Search API

Envoyez une requête de recherche avec les URL des communautés visées sous forme de tâche asynchrone, puis récupérez les publications trouvées.

  1. Définissez votre requête de recherche et indiquez dans urls une ou plusieurs URL de communautés /r/{subreddit}.
  2. Choisissez au besoin sort_by (relevance, hot, top, new, comments) et published_within (de hour à all).
  3. Envoyez une requête POST à /v1/reddit/subreddit-search avec votre clé API SocQ.
  4. Interrogez /v1/tasks/{task_id} et parcourez data.results.items avec next_cursor.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"AI agents","urls":["https://www.reddit.com/r/technology/"],"results_limit":20,"sort_by":"relevance"}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Cas d’usage de la Reddit Subreddit Search API

  • Suivi du sentiment d’une communauté : Observez ce que disent de votre marque ou de vos concurrents les membres de subreddits dédiés à la tech, à la finance ou au jeu vidéo.
  • Repérage des problèmes clients : Cherchez des mots-clés de dépannage et de questions dans des subreddits spécialisés par produit pour trouver les points de friction des utilisateurs.
  • Recherche de niche dans les archives : Retrouvez les discussions historiques les plus notées sur des sujets techniques ou culturels précis, cantonnées à des communautés de référence.

Conseils d’expert pour la Reddit Subreddit Search API

  • Fournissez toujours des URL /r/{subreddit} complètes dans le tableau urls ; le backend extrait automatiquement le nom de la communauté.
  • Préférez cet endpoint à Reddit Search lorsque vous voulez éviter le bruit entre communautés et vous concentrer sur un seul subreddit.
  • Le tri par comments aide à repérer les fils de débat très engagés, où l’opinion de la communauté s’exprime en profondeur.
  • Associez-le à Reddit Comments pour récupérer l’arbre complet des commentaires des publications les plus pertinentes trouvées.

En complément de la Reddit Subreddit Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Reddit.

  • 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 Subreddit Details API
  • 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.
  • Reddit Answers API — Posez une question et obtenez la réponse IA de Reddit avec les commentaires cités, les publications sources et les subreddits recommandés.

Explorer d’autres plateformes

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

Reddit Subreddit Search API — FAQ

Reddit Subreddit Search API permet de rechercher par mot-clé, de façon ciblée, parmi les publications de communautés Reddit précises. Elle renvoie des publications normalisées, les données d’auteur, les horodatages, les votes positifs et le volume de commentaires.

Reddit Search interroge simultanément tous les subreddits publics, tandis que Reddit Subreddit Search limite votre requête aux communautés fournies dans le paramètre urls.

Oui. Indiquez plusieurs liens de communautés dans le tableau urls ; l’endpoint cherche dans chaque subreddit indiqué et regroupe les résultats.