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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé de recherche à exécuter dans la communauté de subreddit indiquée. |
urls | Obligatoire | Tableau d’URL Reddit publiques /r/{subreddit} qui délimitent la communauté dans laquelle chercher. |
results_limit | Facultatif | Nombre maximal de publications renvoyées par communauté ; vaut 100 par défaut, avec une plage autorisée de 1 à 2 000. |
sort_by | Facultatif | Mode de tri des publications trouvées : relevance (par défaut), hot, top, new ou comments. |
published_within | Facultatif | Filtre 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.
- Définissez votre requête de recherche et indiquez dans urls une ou plusieurs URL de communautés /r/{subreddit}.
- Choisissez au besoin sort_by (relevance, hot, top, new, comments) et published_within (de hour à all).
- Envoyez une requête POST à /v1/reddit/subreddit-search avec votre clé API SocQ.
- 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.
API associé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.