reddit/
search

Recherchez des publications Reddit publiques par requête et par période de publication, et obtenez des titres, textes, auteurs, contexte de communauté, horodatages, médias et engagement visible normalisés.

Reddit Search API

Recherche de publications
Période de publication
Contexte de découverte
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 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ètresObligatoireDescription
queryObligatoireTexte obligatoire non vide servant à découvrir des publications Reddit publiques.
results_limitFacultatifNombre maximal de publications à demander. Vaut 100 par défaut et accepte les entiers de 1 à 2 000.
published_withinFacultatifPé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.

  1. Préparez une requête textuelle non vide et choisissez, si vous le souhaitez, une période published_within et un results_limit.
  2. Envoyez les paramètres en POST à /v1/reddit/search et 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, 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 true

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

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.

Explorer d’autres plateformes

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

Reddit Search API — FAQ

Reddit Search API découvre des publications publiques à partir d’une requête textuelle non vide, avec une période de publication et un plafond de résultats facultatifs. Elle renvoie le contenu normalisé des publications, les auteurs, le contexte de subreddit, les médias, les horodatages, l’engagement visible et l’entrée de découverte.

La requête accepte query, results_limit et published_within. query est obligatoire ; l’endpoint n’expose ni URL de subreddit, ni type de contenu, ni contrôles de tri.

Chaque publication normalisée peut inclure son ID, son URL, son titre, son texte, son auteur, le contexte de communauté, les médias, les dates de publication et de collecte, les votes positifs et commentaires visibles, le ratio de votes positifs et l’entrée de découverte.

published_within accepte hour, day, week, month, year ou all. La valeur par défaut est all.

results_limit vaut 100 par défaut et accepte les entiers de 1 à 2 000 comme maximum demandé. Une fois la tâche réussie, poursuivez avec next_cursor tant que has_more vaut true pour lire toutes les pages de résultats stockées.

Chaque résultat de recherche normalisé renvoyé coûte 0,6 crédit SocQ. Un jeu de résultats vide n’entraîne aucun frais de résultat.