Reddit Search
Les résultats de Reddit Search sont des publications publiques correspondant à une requête textuelle, avec titres, corps de texte, auteurs, contexte de subreddit, médias, dates de publication et signaux visibles de votes et de commentaires. Ces enregistrements servent à découvrir des sujets, vérifier des sources, étudier des périodes précises et comparer l’engagement pour des requêtes définies.
Fonctionnalités de la Reddit Search API
- Découverte pilotée par requêteUtilisez une requête textuelle non vide pour découvrir des publications Reddit publiques, sans fournir d’URL de publication ni de subreddit.
- Filtrage par période de publicationLimitez la découverte à la dernière heure, au dernier jour, à la dernière semaine, au dernier mois ou à la dernière année, ou utilisez all pour toute la période prise en charge.
- Requêtes à résultats bornésDéfinissez results_limit de 1 à 2 000 pour contrôler le nombre maximal de publications demandées pour la requête.
- Contexte normalisé de publication et de découverteRenvoie dans un enregistrement cohérent le contenu de la publication, l’auteur et la communauté, les médias, les horodatages, l’engagement visible et l’entrée de découverte.
Paramètres de la Reddit Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Texte obligatoire non vide servant à découvrir des publications Reddit publiques. |
results_limit | Facultatif | Nombre maximal de publications à demander. Vaut 100 par défaut et accepte les entiers de 1 à 2 000. |
published_within | Facultatif | Période de publication des publications trouvées. Vaut all par défaut et accepte hour, day, week, month, year ou all. |
Comment utiliser la Reddit Search API
Envoyez une requête ciblée avec la période souhaitée et un plafond de résultats, puis lisez les publications normalisées une fois la tâche asynchrone terminée.
- Préparez une requête textuelle non vide et choisissez, si vous le souhaitez, une période published_within et un results_limit.
- Envoyez les paramètres en POST à /v1/reddit/search et 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, puis demandez le next_cursor renvoyé tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/reddit/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"machine learning","results_limit":100,"published_within":"month"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Reddit Search API
- Découverte de discussions par sujet : Appuyez-vous sur les titres, les textes, les noms de communautés et les URL de source pour trouver les discussions publiques qui correspondent à un sujet défini.
- Jeux de données de recherche traçables : Conservez les ID, URL, auteurs, dates de publication et discovery_input pour que chaque enregistrement reste relié à sa source et à sa requête.
- Comparaison de l’engagement par période : Combinez published_within avec created_at, collected_at, upvotes_count, comments_count et upvote_ratio pour comparer des échantillons de résultats bornés.
Conseils d’expert pour la Reddit Search API
- Utilisez une requête ciblée qui correspond à une seule question de recherche, afin que le texte des publications trouvées et le contexte de communauté restent interprétables.
- Choisissez published_within pour la période voulue ; laissez la valeur all si une date limite écarterait des publications anciennes pertinentes.
- Considérez results_limit comme un plafond de demande, puis parcourez les curseurs du résultat de la tâche jusqu’à ce que has_more vaille false pour lire tous les résultats stockés.
- Dédoublonnez les recherches répétées par ID de publication en conservant extra.discovery_input et collected_at pour garder le contexte de la requête et de l’observation.
- Traitez les champs d’auteur, de médias, de communauté, d’horodatage et d’engagement comme nullables, car la source publique peut omettre certaines valeurs.
API associées
En complément de la Reddit Search 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 Subreddit Search 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.