RedditGuide APIPublicationsCommentaires

Guide de l’API Reddit : accéder aux publications, commentaires et données de recherche en 2026

Guide pratique 2026 de l’accès à l’API Reddit : OAuth, limites de débit, règles d’usage commercial et collecte de publications et commentaires publics avec les endpoints normalisés de SocQ.

SocQMis à jour le 9 novembre 202613 min de lecture

La bonne façon d’intégrer Reddit dépend de ce que fait réellement votre produit. Un bot de modération installé dans une communauté, un client OAuth non commercial, une étude universitaire et un produit commercial d’écoute sociale n’ont ni le même mode d’accès ni les mêmes responsabilités.

Ce guide présente les options officielles actuelles de Reddit et montre comment récupérer des publications publiques, des commentaires, des flux de subreddits, des métadonnées de subreddits et des résultats de recherche via SocQ, lorsque votre application a besoin d’un endpoint de données managé, en lecture seule.

Réponse rapide : utilisez la Developer Platform officielle de Reddit pour les applications qui s’exécutent sur Reddit, et demandez l’accès à la Data API officielle lorsque votre cas d’usage respecte ses politiques. Utilisez SocQ si vous voulez une seule clé API et des enregistrements Reddit publics normalisés, aux côtés d’autres réseaux sociaux. Aucune de ces deux voies ne vous autorise à ignorer les conditions de Reddit, les obligations de suppression des contenus, les droits liés à la vie privée ni les restrictions sur l’entraînement de modèles.

Les conditions d’accès et les politiques ont été vérifiées le 19 juillet 2026. Reddit peut modifier ses règles d’approbation et ses limites : consultez la documentation officielle liée avant tout lancement.

Quelle API Reddit choisir ?

Reddit décrit désormais plusieurs interfaces distinctes pour les développeurs :

ProduitConçu pourLimite importante
Developer Platform (Devvit)Jeux, utilitaires et applications de modération qui s’exécutent sur RedditL’application est conçue pour l’expérience Reddit
Data APIAccès programmatique approuvé pour lire ou modifier des données RedditOAuth, validation, politiques et limites de débit applicables
Reddit for ResearchersRecherche universitaire éligibleVoie officielle pour la recherche ; candidature obligatoire
Ads APIAnnonceurs qui gèrent leurs campagnes et leurs rapportsWorkflows publicitaires, pas de données de communauté générales
Reddit EmbedsAffichage de contenus Reddit individuelsPrésentation, pas accès massif aux données
API managée de données publiquesWorkflows produit qui ont besoin d’enregistrements publics dans un schéma stableLa couverture et les conditions du fournisseur s’appliquent toujours

La présentation de l’accès développeur de Reddit indique que la Data API est réservée aux développeurs approuvés et que la recherche universitaire doit passer par Reddit for Researchers. L’usage commercial exige l’autorisation de Reddit et un contrat.

Le choix d’une API doit donc commencer par la classification du cas d’usage, et non par une bibliothèque de code.

Exigences de la Data API officielle de Reddit en 2026

Pour un usage gratuit éligible de la Data API, Reddit exige actuellement un jeton OAuth enregistré et un User-Agent descriptif. Le trafic non authentifié peut être bloqué au lieu de bénéficier du quota standard.

Le wiki officiel de la Data API de Reddit indique une limite de 100 requêtes par minute par ID de client OAuth, calculée en moyenne sur une fenêtre de dix minutes. Les clients doivent lire :

  • X-Ratelimit-Used
  • X-Ratelimit-Remaining
  • X-Ratelimit-Reset

Ne considérez pas ces 100 requêtes par minute comme un palier commercial universel. C’est la limite publiée pour les utilisateurs éligibles à l’accès gratuit. Reddit précise que l’usage commercial – y compris les produits payants, financés par la publicité, les services par abonnement et les services vendus contre rémunération – exige une autorisation préalable. Les accès plus larges ou payants sont traités séparément, sans grille tarifaire publique en libre-service.

Reddit impose aussi la gestion des suppressions. Ses consignes actuelles indiquent que les contenus stockés qui ont été supprimés de Reddit doivent l’être de vos systèmes, et que les informations permettant d’identifier l’auteur d’un compte supprimé doivent être effacées. La documentation recommande de supprimer régulièrement les données et contenus d’utilisateurs stockés dans un délai de 48 heures afin de faciliter la conformité.

Exemple d’authentification avec l’API officielle

Une application installée ou de type script échange généralement ses identifiants client et l’autorisation de l’utilisateur contre un jeton OAuth, puis envoie ce jeton à oauth.reddit.com.

Voici la forme simplifiée de la requête :

curl "https://oauth.reddit.com/r/learnpython/new?limit=25" \
  -H "Authorization: Bearer $REDDIT_ACCESS_TOKEN" \
  -H "User-Agent: web:socq-guide:v1.0 (by /u/your_username)"

Les clients en production doivent :

  1. Enregistrer l’application et obtenir l’approbation pour le bon cas d’usage.
  2. Implémenter le type d’autorisation OAuth applicable.
  3. renouveler les jetons qui expirent lorsque c’est pris en charge.
  4. Envoyer un User-Agent sincère et unique.
  5. Respecter les en-têtes de limite de débit et ralentir avant d’atteindre le plafond.
  6. Traiter les suppressions et les changements de politique.

Les développeurs Python utilisent souvent PRAW pour gérer les objets de listing, la pagination et les détails d’OAuth. Le HTTP direct peut convenir quand vous voulez moins de dépendances, mais il ne supprime aucune obligation liée aux politiques de Reddit.

Récupérer une publication Reddit par URL avec SocQ

Reddit Posts API de SocQ accepte les URL de publications Reddit publiques et les liens courts redd.it. Elle renvoie le titre, le corps, l’auteur, le contexte de la communauté, les horodatages, les références aux médias publics et l’engagement visible, sous une forme normalisée.

curl -X POST "https://api.socq.ai/v1/reddit/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
    ]
  }'

La requête crée une tâche asynchrone. Conservez le task_id renvoyé, puis interrogez l’état de la tâche :

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Lorsque la tâche aboutit, les enregistrements se trouvent dans data.results.items. Poursuivez avec next_cursor tant que has_more vaut true.

Un enregistrement de publication suit la même structure générale que les autres ressources SocQ :

{
  "id": "post_id",
  "platform": "reddit",
  "resource": "posts",
  "type": "post",
  "url": "https://www.reddit.com/r/learnpython/comments/post_id/example/",
  "name": "Example post title",
  "text": "Example post body",
  "author": {
    "username": "example_user",
    "name": "example_user"
  },
  "metrics": {
    "upvotes_count": 842,
    "comments_count": 54,
    "upvote_ratio": 0.96
  },
  "created_at": "2026-07-16T08:00:00Z",
  "collected_at": "2026-07-19T08:00:00Z",
  "extra": {
    "tag": "Discussion",
    "community_name": "learnpython"
  }
}

Les scores visibles sont des instantanés, pas une vérité définitive. Reddit peut brouiller le décompte des votes, un contenu peut être modifié ou supprimé, et une collecte ultérieure peut donner un résultat différent.

Récupérer les commentaires Reddit

Utilisez Reddit Comments API lorsque vous avez besoin de la discussion publique sous des URL de publications connues :

curl -X POST "https://api.socq.ai/v1/reddit/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
    ]
  }'

Les enregistrements de commentaires normalisés comprennent :

  • L’ID, l’URL et le texte du commentaire.
  • Les champs publics de l’auteur, lorsqu’ils sont disponibles.
  • Les nombres de votes positifs et de réponses visibles.
  • Les références à la publication source et à la communauté.
  • L’ID du commentaire parent, lorsqu’il est disponible.
  • Les horodatages de publication et de collecte.

L’endpoint SocQ actuel n’accepte pas de paramètre results_limit. Ne partez pas du principe que chaque branche visible, chaque réponse repliée, chaque commentaire supprimé, chaque élément réservé aux modérateurs ou chaque résultat classé dynamiquement sera renvoyé. Si la reconstitution complète d’un fil est une exigence impérative, testez des fils représentatifs, profonds et volumineux avant de choisir un fournisseur.

Récupérer les publications new, top ou hot d’un subreddit

Pour surveiller une communauté, Reddit Subreddit Posts API accepte une ou plusieurs URL de subreddits publics. sort_by prend en charge new, top et hot ; results_limit accepte de 1 à 2 000 par subreddit soumis.

curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/",
      "https://www.reddit.com/r/webdev/"
    ],
    "sort_by": "new",
    "results_limit": 250
  }'

Choisissez le tri de façon réfléchie :

TriMeilleur usageLimite
newSurveillance incrémentale et alertesInclut davantage de publications peu pertinentes
hotAttention actuelle de la communautéLe classement change en permanence
topDécouverte des contenus très engageantsPeut surreprésenter des contenus plus anciens ou déjà populaires

Pour la surveillance, collectez new selon un calendrier et dédupliquez par ID de publication. Utilisez hot ou top comme vue de découverte distincte plutôt que d’écraser le flux chronologique.

Rechercher des publications Reddit par mot-clé

Reddit Search API accepte une requête, une limite de résultats de 1 à 2 000 et une fenêtre de publication :

curl -X POST "https://api.socq.ai/v1/reddit/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "\"social listening\" API",
    "results_limit": 500,
    "published_within": "month"
  }'

Les fenêtres prises en charge sont hour, day, week, month, year et all.

Les résultats de recherche sont des résultats de découverte classés, pas une archive exhaustive garantie. La syntaxe de la requête, le classement, la disponibilité et l’indexation peuvent tous influencer la couverture. Lancez plusieurs requêtes ciblées plutôt que d’attendre d’une seule requête large qu’elle représente toute la conversation.

Pour la surveillance de marque, par exemple, utilisez un ensemble de requêtes :

"Acme Cloud"
acmecloud
"Acme API"
"Acme Cloud" pricing
"Acme Cloud" alternative

Conservez la requête dans le contexte de découverte afin que les analystes puissent expliquer pourquoi chaque enregistrement est entré dans le jeu de données.

Détails d’un subreddit et recherche dans un subreddit

Deux autres endpoints couvrent la communauté elle-même. Reddit Subreddit Details API prend des URL de subreddits publics et renvoie des métadonnées comme le nombre d’abonnés, les utilisateurs actifs hebdomadaires, les règles et les ressources de la communauté. C’est un moyen peu coûteux de qualifier une communauté avant de la surveiller.

Reddit Subreddit Search API recherche les discussions et publications publiques au sein d’un subreddit précis, par requête, période et ordre de tri. Utilisez-la lorsqu’un terme de marque n’est pertinent que dans quelques communautés et qu’une recherche sur tout Reddit le noierait. Consultez la page de chaque endpoint pour connaître les champs d’entrée exacts.

Construire un pipeline de surveillance Reddit fiable

Un workflow durable sépare la collecte, le stockage et l’analyse :

Query/subreddit registry
        ↓
Scheduled SocQ submissions
        ↓
Task polling with backoff
        ↓
Normalize + deduplicate by Reddit ID
        ↓
Deletion/retention controls
        ↓
Classification, alerts and reporting

Règles d’implémentation recommandées :

  1. Utilisez des ID stables. Les URL et les slugs peuvent changer ; les ID Reddit sont de meilleures clés de déduplication.
  2. Conservez le contexte source. Stockez le subreddit, la requête, le tri et l’heure de collecte.
  3. Séparez les instantanés des entités. Les métriques changent, alors que l’ID de la publication reste stable.
  4. Relancez les tâches, pas les enregistrements individuels. Un backoff exponentiel évite les soumissions en double.
  5. Consignez les états manquant et supprimé. Ne transformez pas une absence en publication vide mais valide.
  6. Limitez les données personnelles. La plupart des analyses n’ont pas besoin d’historiques d’auteurs à long terme.
  7. Prévoyez un chemin d’effacement. Votre modèle de données doit pouvoir supprimer les contenus et les références aux auteurs.

API officielle de Reddit et SocQ

BesoinAPI officielle de RedditSocQ
Créer une application ou un outil de modération sur RedditMeilleur choixNon pris en charge
Lire et écrire des actions RedditPris en charge sous réserve d’approbation et de scopesDonnées publiques en lecture seule
OAuth et enregistrement d’une application RedditObligatoiresClé API SocQ
Normalisation des publications et commentaires publicsObjets natifs de RedditSchéma SocQ commun
Produit social multiplateformeIntégrations séparéesMême modèle de tâche sur 27 plateformes
Limite de débit gratuite publiée100 requêtes par minute pour les clients OAuth éligiblesTarifs des endpoints dans le catalogue SocQ
Autorisation commercialeAutorisation ou contrat de Reddit à obtenirL’accès via un fournisseur ne lève pas les règles de Reddit
Recherche universitaireReddit for Researchers obligatoireNe pas l’utiliser pour contourner la politique

Choisissez la voie officielle si votre produit effectue des actions autorisées par l’utilisateur, de la modération, des publications, des votes, des messages ou des intégrations approfondies natives de Reddit. Choisissez SocQ pour la collecte de données publiques prises en charge, lorsque des enregistrements multiplateformes normalisés et une extraction managée comptent plus que l’accès en écriture.

Estimer la charge de travail et le coût

Ne comparez pas les fournisseurs uniquement en nombre de « requêtes ». Une requête peut renvoyer une publication, une page de commentaires ou des centaines de résultats de subreddit.

Estimez :

monthly records =
  direct post lookups
  + comments returned
  + subreddit posts returned
  + search results returned

monthly workload =
  schedules × inputs per run × average records per input

Tenez ensuite compte des éléments suivants :

  • Les résultats vides ou indisponibles.
  • La fréquence d’actualisation.
  • Les recoupements entre recherches et la déduplication.
  • Les fils de commentaires profonds.
  • Le stockage et le traitement des suppressions.
  • Les exigences de concurrence et de latence.
  • La facturation ou non des seuls résultats réussis.

Menez un pilote représentatif sur de petites et de grandes communautés avant de projeter les dépenses annuelles.

Usage responsable et conservation des données

Une donnée publiquement accessible n’autorise pas pour autant tous les usages. Les politiques actuelles de Reddit restreignent l’accès commercial sans approbation et interdisent d’utiliser le contenu de Reddit pour entraîner des modèles sans consentement explicite. Elles imposent aussi des obligations de suppression.

Mettez en place les contrôles suivants avant de passer à l’échelle :

  • Ne collectez que les champs nécessaires à la finalité déclarée.
  • Évitez le profilage de personnes sensibles et le harcèlement individuel.
  • N’utilisez pas l’API pour contourner les restrictions d’un subreddit ou d’un compte.
  • Conservez l’attribution de la source lorsque le contenu est affiché.
  • Définissez des durées de conservation courtes pour les contenus bruts.
  • Revérifiez ou supprimez les contenus qui ne sont plus disponibles.
  • Protégez les clés API et auditez l’accès aux exports.
  • Faites réaliser une revue juridique pour les usages commerciaux, de recherche ou à haut risque.

SocQ est une couche d’accès technique, et non une cession de droits de propriété intellectuelle, de droits liés à la vie privée, de recherche ou de droits commerciaux.

FAQ sur l’API Reddit

L’API Reddit est-elle gratuite ?

Reddit propose un accès gratuit ou payant selon le cas d’usage. Les clients éligibles de la Data API gratuite sont actuellement soumis à une limite publiée de 100 requêtes par minute par ID de client OAuth. L’usage commercial exige l’autorisation de Reddit et peut nécessiter un contrat et des frais.

Peut-on utiliser l’API Reddit sans OAuth ?

Ne basez pas votre conception sur un accès non authentifié. La documentation actuelle de Reddit exige des jetons OAuth enregistrés et indique que le trafic sans OAuth ni identifiants de connexion sera bloqué.

Puis-je scraper Reddit pour entraîner une IA ?

Reddit indique que son contenu ne peut pas servir d’entrée pour l’entraînement de modèles sans consentement explicite. Une API tierce ne lève pas cette restriction.

SocQ prend-il en charge les commentaires Reddit ?

Oui. SocQ propose six endpoints Reddit : publications directes, commentaires à partir d’URL de publications, découverte des publications d’un subreddit, détails d’un subreddit, recherche par mot-clé sur tout Reddit et recherche dans un seul subreddit.

SocQ peut-il publier, voter ou modérer sur Reddit ?

Non. Les endpoints Reddit de SocQ collectent les enregistrements publics pris en charge. Utilisez les produits officiels de Reddit pour les développeurs pour les actions d’écriture autorisées et la modération.

Les résultats de recherche Reddit sont-ils exhaustifs ?

Non. Considérez la recherche comme de la découverte classée. Les résultats dépendent de la requête, de la fenêtre temporelle, de l’indexation et de la disponibilité ; ce n’est pas une archive historique complète.

Que se passe-t-il quand un utilisateur Reddit supprime un contenu ?

Votre système doit pouvoir supprimer le contenu et les informations qui identifient son auteur. Les consignes officielles de Reddit recommandent de supprimer régulièrement les données et contenus d’utilisateurs stockés dans un délai de 48 heures pour simplifier la conformité.

REDDIT API

Tester le workflow avec une URL publique Reddit

Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.

Découvrir les API Reddit