Retour aux API
Données publiques Reddit

Reddit Public Data API

Récupérez les publications et commentaires Reddit publics à partir d’URL connues, parcourez les publications récentes, les mieux notées ou tendance d’un subreddit, ou recherchez des discussions par mot-clé et par période de publication.

API Reddit disponibles

Posts pour une publication connue, Comments pour ses réponses publiques, Subreddit Posts pour le fil d’une communauté, ou Search pour la découverte par mot-clé.

Quelles données Reddit pouvez-vous récupérer ?

SocQ renvoie du contenu Reddit public normalisé, avec le contexte de communauté, de réponses, de découverte, d’engagement et de date de collecte nécessaire à l’analyse des discussions.

Publications et engagement visible

Récupérez les titres, le corps du texte, les auteurs, les flairs, le contexte de la communauté, les médias, les URL de source et les indicateurs visibles rattachés à collected_at.

Commentaires et relations de réponse

Récupérez le texte des commentaires publics, les auteurs, les références à la publication d’origine et au commentaire parent, les horodatages, les votes positifs et le nombre de réponses.

Exploration des subreddits

Parcourez les publications récentes, les mieux notées ou tendance à partir d’URL /r/{subreddit}, avec une limite de résultats distincte pour chaque communauté.

Recherche par mot-clé

Recherchez des publications publiques à partir d’une requête textuelle et d’une période de publication, en gardant ensemble la publication trouvée et son contexte de découverte.

SocQ vs Reddit Data API

SocQ propose des flux de collecte de données Reddit publiques. La Data API de Reddit est l’interface officielle destinée aux applications approuvées qui lisent ou modifient des données Reddit.

FonctionnalitéSocQReddit Data API
Usage principalCollecter des publications, des commentaires, des listes de subreddits et des résultats de recherche publicsCréer des applications, des intégrations et des outils de modération Reddit approuvés
AuthentificationClé API SocQ ; pas d’OAuth utilisateur RedditApprobation de Reddit, identifiants OAuth et identité d’application déclarée
Entrée de départURL de publication ou de subreddit publique, ou requête textuelleEndpoints Reddit, fullnames, paramètres de liste et scopes OAuth
Publier, voter ou modérerNon pris en chargePris en charge pour les cas d’usage approuvés, avec les scopes utilisateur requis
Format de réponseEnregistrements SocQ normalisésObjets et listes natifs de Reddit

Fonctionnement de l’API Reddit

La collecte directe, l’exploration de subreddits et la recherche par mot-clé suivent le même flux : tâche asynchrone, puis résultats paginés.

  1. 1. Envoyer votre entrée

    Envoyez des URL de publications, des URL de subreddits ou une requête de recherche à l’API correspondante et conservez le task_id renvoyé.

  2. 2. Suivre la tâche

    Interrogez /v1/tasks/{task_id} jusqu’à la fin du traitement.

  3. 3. Récupérer les résultats

    Lisez data.results.items et utilisez next_cursor tant que has_more vaut true.

Rechercher des discussions Reddit publiques

Authentifiez-vous avec votre clé API SocQ et envoyez un mot-clé accompagné d’une période de publication. Les autres API Reddit suivent le même flux de tâche.

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 courants de l’API Reddit

Veille sur les communautés

Collectez les publications récentes, les mieux notées ou tendance de subreddits choisis et comparez l’activité visible d’une communauté à l’autre.

Analyse des discussions et des réactions

Étudiez le contenu des publications, le texte des commentaires, les relations de réponse, les auteurs et l’engagement au moment de la collecte au sein de discussions précises.

Étude de sujets et de marché

Recherchez des mots-clés et des périodes définis pour repérer les discussions publiques autour de produits, de marques, de concurrents ou de tendances.

Archives et jeux de données de recherche

Conservez les publications et commentaires publics, les liens de source, le contexte de communauté, les horodatages et les indicateurs visibles pour des analyses reproductibles.

Limites et politique sur les données publiques

Les résultats Reddit sont des enregistrements publics à un instant donné. Ces API n’accèdent ni aux communautés privées, ni aux contenus supprimés, ni aux données de compte, ni aux outils de modération.

  • Posts et Comments acceptent les URL de publications prises en charge ou les liens redd.it. Subreddit Posts exige un chemin /r/{subreddit} exact.
  • Subreddit Posts prend en charge le tri par récents, mieux notés ou tendance, avec results_limit appliqué séparément à chaque URL de subreddit.
  • Search accepte une requête, un results_limit de 1 à 2 000 et une période de publication : heure, jour, semaine, mois, année ou toute la durée. Elle n’expose ni filtre de subreddit ni filtre de tri.
  • Posts et Comments restent des ressources distinctes ; une publication inclut comments_count, mais pas les commentaires individuels.
  • Comments renvoie les commentaires publics visibles, sans garantir un arbre de réponses complet ni toute la profondeur historique de la discussion.
  • Les indicateurs visibles sont des instantanés rattachés à collected_at. Les champs facultatifs peuvent être null ou vides lorsque la source publique ne les expose pas.

Questions fréquentes sur l’API Reddit

Qu’est-ce que l’API Reddit ?

L’API Reddit est un ensemble d’endpoints SocQ pour récupérer des publications et commentaires publics connus, parcourir les publications d’un subreddit et rechercher des discussions publiques par mot-clé et par période de publication.

Quels liens Reddit sont acceptés ?

Posts et Comments acceptent les chemins /r/{subreddit}/comments/{post_id} pris en charge ou les liens redd.it. Subreddit Posts accepte un chemin /r/{subreddit} exact.

Quelle API Reddit choisir ?

Utilisez Posts pour une publication connue, Comments pour ses réponses publiques, Subreddit Posts pour la liste d’une communauté, et Search pour la découverte par mot-clé.

Quelle différence entre l’exploration d’un subreddit et la recherche Reddit ?

Subreddit Posts parcourt les publications récentes, les mieux notées ou tendance à partir d’URL /r/{subreddit} exactes. Search trouve des publications publiques à partir d’une requête textuelle et d’une période de publication.

Les commentaires Reddit et les indicateurs d’engagement sont-ils complets ou en temps réel ?

Non. Comments reflète les réponses publiques visibles au moment de la collecte, et les valeurs d’engagement sont des instantanés à un instant donné, pas un historique complet ni un flux en temps réel.

Comment la collecte Reddit est-elle facturée ?

Chaque résultat de Posts ou de Subreddit Posts coûte 0,5 crédit, chaque commentaire coûte 0,3 crédit et chaque résultat de Search coûte 0,6 crédit ; un jeu de résultats vide n’entraîne aucun frais de résultat.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.