Documentation de l'API OAuth de Reddit : 10 points essentiels à connaître avant de développer

Écrit par :

Iryna Bundzylo

8

min de lecture

Date :

July 30, 2026

Date de modification :

July 30, 2026

Fin mai 2026, Reddit a discrètement activé une modification qui a rendu de nombreux logiciels inopérants du jour au lendemain. Les requêtes non authentifiées, y compris l'astuce .json sur laquelle reposaient depuis des années les scrapers, les scripts amateurs et même certains serveurs MCP, ont commencé à renvoyer des erreurs HTTP 403.

Vue d'ensemble :

  • OAuth est désormais une exigence stricte et les raccourcis obsolètes sont officiellement abandonnés.
  • L'enregistrement d'une application n'est qu'une première étape : les nouveaux clients OAuth doivent également obtenir l'approbation de Reddit avant de pouvoir être utilisés.
  • Les échecs d'implémentation les plus fréquents proviennent souvent de petites erreurs de configuration plutôt que de code défectueux.
  • Les limites de débit publiées ne reflètent pas toujours la réalité ; votre application doit donc se fier aux en-têtes de réponse.
  • L'authentification n'est que la moitié du travail ; les exigences de conformité peuvent avoir un impact encore plus important sur les intégrations en production.

Si votre intégration reposait sur ce raccourci, elle est désormais obsolète. Si ce n'était pas le cas, c'est tout de même le moment idéal pour vérifier que votre implémentation OAuth est réellement robuste. La documentation de Reddit couvre assez bien les mécanismes. Ce qu'elle ne fait pas, c'est vous avertir des points où ces mécanismes deviennent risqués. Analysons ensemble la situation dans son ensemble.

Ceci est un aperçu technique destiné à la planification de votre implémentation et ne constitue pas un conseil juridique. Les conditions d'utilisation de l'API de Reddit et sa politique d'application ont considérablement évolué ces dernières années et pourraient encore changer (qui sait) – confirmez les questions relatives à l'utilisation commerciale et aux licences auprès d'un conseiller juridique avant de construire quoi que ce soit qui en dépende.

Documentation de l'API OAuth de Reddit : Les bases du flux d'authentification

Buff Doge vs. Cheems meme – picking the wrong app type for the job meme

1. OAuth n'est pas optionnel et son application est stricte

Reddit bloque le trafic sans OAuth ou identifiants de connexion, et n'hésitera pas à limiter ou bloquer les utilisateurs de l'API qu'il ne peut pas identifier. Si votre organisation a hérité d'un scraper conçu avant les changements de l'API de Reddit en 2023, considérez qu'il ne lui reste que peu de temps à vivre.

2. L'enregistrement est l'étape zéro, mais ce n'est plus le seul verrou

Vous enregistrez une application sur reddit.com/prefs/apps, choisissez un type, définissez une URI de redirection et obtenez un identifiant client (ainsi qu'un secret, pour les applications confidentielles). Reddit distingue trois types :

  • Applications de script – pour un usage personnel ou côté serveur. Vous autorisez votre propre compte via une étape d'autorisation unique, plutôt que de créer un flux de connexion pour d'autres utilisateurs.
  • Applications web – le flux complet basé sur la redirection, pour autoriser d'autres utilisateurs Reddit.
  • Applications installées – contextes côté client/mobile qui ne peuvent pas stocker un secret en toute sécurité.

Les applications de script et web sont confidentielles ; les applications installées ne le sont pas. Choisir "script" parce que cela semble plus simple, alors que vous avez en réalité besoin d'autoriser d'autres utilisateurs, signifie devoir reconstruire votre couche d'authentification deux mois plus tard.

Dernière précision : depuis fin 2025, enregistrer l'application est nécessaire mais ne suffit plus. Les nouvelles applications demandant l'accès à l'API Reddit Data peuvent nécessiter une approbation au titre de la Responsible Builder Policy de Reddit avant que l'accès en production ne soit accordé.

3. Le flux d'authentification dépend du type d'application

C'est ici que beaucoup d'intégrations sont mal configurées.

  • Seules les applications web utilisent le flux de code d'autorisation au sens classique : rediriger l'utilisateur, obtenir un code, l'échanger.
  • Les applications de script fonctionnent différemment : elles s'authentifient directement avec le grant type password (grant_type=password), en transmettant le nom d'utilisateur et le mot de passe Reddit du développeur avec les identifiants client. C'est l'approche actuelle et documentée pour les applications de script, et non une méthode obsolète à remplacer par quelque chose de plus "standard" – essayer de forcer une application de script à utiliser le flux de code d'autorisation ne fera que vous conduire à déboguer un flux que Reddit n'a jamais prévu.
  • Les applications installées se situent entre les deux : elles utilisent toujours le flux de code d'autorisation, mais sans secret client, puisqu'elles ne peuvent pas en stocker un en toute sécurité, et ce sont les seules applications pouvant également recourir au flux implicite.

Si vous vous trompez de type de grant pour votre type d'application, les erreurs que vous verrez ressembleront à des identifiants incorrects, alors que le véritable problème réside dans le flux lui-même.

4. state et la correspondance exacte des URI de redirection sont les causes d'échecs silencieux

Deux exigences, un même scénario d'échec : la requête semble correcte, mais l'API Reddit la rejette quand même.

  • state : une valeur unique par demande d'autorisation, vérifiée au retour, empêche le piratage de type CSRF. L'ignorer constitue une réelle faille de sécurité, pas seulement une remarque d'audit.
  • redirect_uri : doit correspondre, caractère pour caractère, à ce qui est enregistré – à la fois lors de l'étape d'autorisation et lors de l'échange de jeton. Un slash final ou une erreur de frappe http/https entraîne un échec silencieux.

5. Les jetons expirent en une heure – prévoyez le rafraîchissement dès le premier jour

Les jetons d'accès (bearer tokens) expirent au bout d'une heure. Cela ne pose aucun problème jusqu'au jour où une intégration testée avec succès tombe en panne en production parce que personne n'a prévu le flux de rafraîchissement. Si vous avez besoin d'un accès continu, demandez un jeton de rafraîchissement avec duration=permanent lors de l'autorisation, et développez la logique de rafraîchissement avant la mise en ligne, plutôt qu'après la première interruption.

Déjà épuisé après le cinquième point ? Nous aussi. Data365 transforme tout cela en un seul appel d'API fluide. Contactez-nous et laissez ces Hunger Games derrière vous.

Documentation de l'API OAuth de Reddit : limites de débit et portées (scopes)

Suspicious Dog Meme – Reddit API rate limit meme

6. Portées (scopes) : demandez-en le moins possible

Les jetons sont limités par des portées (lecture, soumission, vote, journal de modération, publications de modération, etc.). Évitez de demander des accès étendus « au cas où » : les jetons aux portées trop larges constituent un risque pour la sécurité, et une demande qui se limite strictement à ce dont elle a besoin sera beaucoup plus facile à justifier si vous sollicitez un jour un accès commercial ou privilégié.

7. Appelez oauth.reddit.com, et non www.reddit.com

Une fois que vous disposez d'un jeton d'accès, les requêtes doivent être envoyées à oauth.reddit.com. Utiliser le domaine principal du site entraîne des erreurs déroutantes qui n'ont rien à voir avec votre logique d'authentification. Si rien ne semble fonctionner, vérifiez d'abord le nom d'hôte.

8. Les limites de débit sont plus basses et plus strictes que ce que suggèrent la plupart des tutoriels

Les conditions d'utilisation de l'API Data de Reddit décrivent une limite pour l'offre gratuite de 100 requêtes par minute avec OAuth, calculée en moyenne sur une fenêtre de 10 minutes. Pourtant, les utilisateurs décrivent les limites de l'API Reddit différemment : 100 requêtes par minute par client OAuth. 

Ne basez pas votre planification de capacité sur des chiffres pris au hasard ; fiez-vous aux en-têtes de réponse comme source de vérité : X-Ratelimit-Used, X-Ratelimit-Remaining et X-Ratelimit-Reset sont renvoyés à chaque requête et vous indiquent précisément où vous en êtes, indépendamment des chiffres officiels publiés.

C'est aussi le moment où les équipes commencent à se demander s'il vaut mieux gérer elles-mêmes les applications OAuth et la régulation du débit, ou confier cette couche à quelqu'un qui l'a déjà fait. Chez Data365, c'est précisément le problème pour lequel notre pipeline a été conçu : nous gérons le renouvellement des jetons, la surveillance des en-têtes et le backoff une bonne fois pour toutes, afin de fournir des données prêtes à l'emploi. Si vous préférez consacrer votre temps d'ingénierie à votre produit plutôt qu'à des files d'attente de requêtes, cela vaut la peine de nous contacter.

Documentation de l'API OAuth de Reddit : conformité et conditions à surveiller

Suspicious Leo – Reddit docs disagreeing on compliance and terms of use

9. Le niveau gratuit n'est pas un feu vert pour un usage commercial ou pour éviter l'approbation

Le niveau gratuit est explicitement exclu de tout usage commercial, et les conditions d'utilisation de l'API de données de Reddit imposent des restrictions supplémentaires sur l'utilisation des données, une limite que Reddit fait activement respecter plutôt que de la traiter comme une simple formalité. Il est utile de répéter ce qui a été dit au point 2 : même l'accès gratuit et non commercial nécessite désormais cette même étape d'approbation préalable. Il n'existe plus de parcours entièrement en libre-service pour obtenir un jeton fonctionnel.

Quelques exigences de conformité mineures méritent également d'être mentionnées :

  • Utilisez un User-Agent unique et descriptif (plateforme:id_app:version (par /u/nomdutilisateur)) – les agents génériques sont fortement limités.
  • Supprimez le contenu utilisateur dès qu'il est supprimé de Reddit.
  • Prévoyez du temps pour l'approbation : c'est fiable pour les outils de modération et la recherche financée, mais lent et souvent sans réponse pour les charges de travail commerciales.

Si votre projet comporte une dimension commerciale, c'est cette section – et non la poignée de main OAuth – que vous devez soumettre à votre service juridique avant d'écrire la moindre ligne de code.

10. Considérez la documentation elle-même comme une cible mouvante

Les archives de Reddit et sa documentation actuelle ne concordent pas toujours entre elles, ni avec les guides tiers (voir le point 8). Avant toute décision de mise en production, vérifiez directement les Conditions pour les développeurs et les Conditions de l'API Data en vigueur — pas un wiki archivé, pas un tutoriel vieux de deux ans, et pas cet article dans six mois.

Si l'intégration directe OAuth s'avère plus complexe que ce que votre équipe souhaite gérer, surtout une fois que les files d'attente d'approbation et la gestion des limites de débit entrent en jeu, c'est précisément le problème que l'API Social Media de Data365 est conçue pour résoudre.

En résumé : liste de contrôle rapide pour la documentation de l'API OAuth de Reddit

  1. Enregistrez l'application, notez l'identifiant client (et le secret, le cas échéant), et soumettez une demande d'approbation conformément à la politique « Responsible Builder » de Reddit s'il s'agit d'un nouveau client OAuth.
  2. Choisissez le type d'application approprié (script, web ou installé) avant d'écrire du code.
  3. Construisez l'URL d'autorisation avec client_id, response_type, state, redirect_uri et scope.
  4. Vérifiez l'état (state) au retour et confirmez que redirect_uri correspond exactement.
  5. Échangez le code d'autorisation contre un jeton d'accès.
  6. Demandez duration=permanent et stockez le jeton de rafraîchissement en toute sécurité si vous avez besoin d'un accès continu.
  7. Envoyez les requêtes à oauth.reddit.com avec Authorization: bearer TOKEN.
  8. Surveillez X-Ratelimit-Used, X-Ratelimit-Remaining et X-Ratelimit-Reset à chaque réponse.
  9. Utilisez un User-Agent unique et descriptif au format requis.
  10. Confirmez que votre cas d'utilisation est couvert par les conditions non commerciales du niveau gratuit, ou entamez rapidement la procédure d'approbation.
  11. Supprimez les données utilisateur lorsque le contenu ou le compte source est supprimé.
  12. Vérifiez à nouveau tous ces points par rapport aux conditions actuelles de Reddit avant la mise en production.

Douze étapes franchies. Félicitations : vous en savez désormais plus sur le flux OAuth de Reddit que ce que la plupart des pages de documentation de Reddit elles-mêmes ne confirment.

Si vous préférez éviter ce parcours du combattant pour chaque plateforme – Twitter aujourd'hui, TikTok le trimestre prochain, et Pinterest entre les deux – sachez que Data365 consacre son activité depuis 2018 à faire en sorte que les changements hebdomadaires des conditions d'utilisation des API deviennent le problème de quelqu'un d'autre.

  • Le processus d'approbation n'a rien d'un parcours du combattant – contactez-nous pour discuter de vos besoins et de vos volumes, et nous vous aiderons à démarrer au plus vite.
  • Une API, de nombreuses plateformes – Reddit, Facebook, Instagram, TikTok, Threads et d'autres, centralisés sous une logique unique.
  • Plus de 20 types de données structurées – publications, commentaires, médias, et plus encore.
  • Requêtes en temps réel, pas de snapshots en cache – vous obtenez des données actualisées au moment de la requête, ainsi que du contenu historique à la demande via des paramètres de requête.
  • Sortie JSON propre – conçue pour les pipelines, sans étape intermédiaire de parsing ou de nettoyage.
  • 99 % de disponibilité sur l'infrastructure sous-jacente.
  • Une documentation faite pour être lue, soutenue par une équipe de support composée de vraies personnes plutôt que par une file d'attente de tickets.

Plus de 200 entreprises ont déjà externalisé cette corvée. Profitez d'un essai gratuit avec Data365 et consacrez-vous enfin à ce que vous vouliez vraiment créer.

Extrayez des données des principaux réseaux sociaux avec l'API Data365

Demandez un essai gratuit de 14 jours et obtenez plus de 20 types de données

Contactez-nous
Sommaire
Besoin d'une API pour extraire des données de ce réseau social ?
Contactez-nous et obtenez un essai gratuit de l'API Data365
Demander un essai gratuit

Besoin d'extraire des données des réseaux sociaux ?

Demandez un essai gratuit de l'API Data365 pour l'extraction de données

Les principaux réseaux sociaux au même endroit
Tarification équitable
Support par e-mail
Documentation API détaillée
Données exhaustives, quel que soit le volume
Aucune interruption, disponibilité garantie d'au moins 99 %

FAQ

Ai-je toujours besoin d'OAuth pour utiliser l'API de Reddit ?

Oui. Depuis mai 2026, Reddit bloque tout trafic non authentifié, y compris l'ancienne astuce .json – chaque requête nécessite un jeton OAuth valide lié à une application enregistrée.

Puis-je enregistrer une application et commencer à extraire des données immédiatement ?

Plus maintenant. L'enregistrement vous donne seulement un identifiant client. Les nouveaux jetons OAuth nécessitent également une approbation selon la politique « Responsible Builder » de Reddit, ce qui peut prendre de quelques jours à plusieurs semaines.

Quelle est la limite de débit réelle de l'API de Reddit ?

Les conditions officielles indiquent 100 requêtes/minute (moyenne sur 10 min) ; plusieurs guides de développement mentionnent 60/minute. Ne devinez pas – lisez les en-têtes X-Ratelimit-* sur chaque réponse pour obtenir le chiffre exact.

Pourquoi mon flux OAuth échoue-t-il sans erreur explicite ?

Il s'agit généralement d'une redirect_uri non correspondante ou d'un paramètre state manquant. Les deux doivent correspondre exactement à ce que vous avez enregistré ; même un slash final peut provoquer un échec silencieux.

Besoin d'une API pour extraire des données en temps réel des réseaux sociaux ?

Soumettez un formulaire pour obtenir un essai gratuit de l'API réseaux sociaux de Data365.
0/255

En soumettant ce formulaire, vous reconnaissez avoir lu, compris et accepté nos Conditions générales, qui décrivent la manière dont vos données seront collectées, utilisées et protégées. Vous pouvez consulter l'intégralité de notre Politique de confidentialité ici.

Merci ! Votre soumission a bien été reçue !
Oups ! Une erreur est survenue lors de l'envoi du formulaire.
Approuvé par