Newbie Paintball Master

    TypeScript icon, indicating that this package has built-in type declarations

    1.1.6 • Public • Published

    Reddit-Wrapper-V2 - Reddit API framework for Nodejs

    npm package

    Simple to use

    Reddit-Wrapper is designed to be a simple to user reddit API wrapper, while also providing robust error handling and retry capabilities. Every function returns a promise. Allowing the user to easily handle errors in the catch, and results in the then.

    Now with TypeScript definitions! (Thanks @yliaho)

    This wrapper also has a lot of error handling functionality. As Reddit sometimes errors out in strange ways (random 403's, "You are doing this too much...") handling it within this wrapper allows users to focus on non reddit functionality. Find below all the error handling strategies you can opt into. By default no error handling options are enabled except for automatic 403 retries.

    Simple API usage:

    reddit.api.get("/subreddits/mine/subscriber", {
            limit: 2,
    .then(function(response) {
        let responseCode = response[0];
        let responseData = response[1];
        console.log("Received response (" + responseCode + "): ", responseData);
    .catch(function(err) {
        console.log("Reddit Error: ", err);

    Table of Contents

    Setup and Configuration

    Installing reddit-wrapper-v2

    npm install reddit-wrapper-v2 --save

    Library usage and configuration

    var RedditAPI = require('reddit-wrapper-v2');
    var redditConn = new RedditAPI({
            // Options for Reddit Wrapper
            username: 'reddit_username',
            password: 'reddit password',
            app_id: 'reddit api app id',
            api_secret: 'reddit api secret',
            user_agent: 'user agent for your bot',
            retry_on_wait: true,
            retry_on_server_error: 5,
            retry_delay: 1,
            logs: true

    Reddit API Options

    Option Name Option Default Description Required
    username null The Username for the Reddit Account. True
    password null The Password for the Reddit Account. True
    app_id null The Reddit Application ID. True
    api_secret null The Reddit Application Secret. True
    logs False Display logs. False
    user_agent Reddit-Watcher-V2 The User Agent for all Reddit API requests. False
    retry_on_wait False If True and Reddit returns a "You are trying this too much" error, it will pause the process for the exact time needed, then retry the request. False
    retry_on_server_error 0 If > 0 and Reddit returns a server error (responseCode >= 500 && responseCode <= 599) it will retry the request the number of times you specify + 1 automatically. False
    retry_delay 5 sec. Specifies the retry delay for server error retries. (IE. if server error and you specify you want to retry before retrying it will delay for retry_delay seconds.) False

    API setup

    All you need to get up and running is obtain an api_id and an api_secret. Both can be created on the Reddit app console

    1. Create (or log into) a reddit account
    2. Navigate to the authorized applications console
    3. Select 'create another app...' at the bottom
    4. Fill in the name, description and click on 'script', put in anything for the redirect uri, its not needed and you can change it later if you want to
    5. Copy down the 'secret' that is your api_secret, the 14 character string by the name of your app is your app_id
    6. Use these values and your credentials to configure the snooper

    Reddit API

    The API component is an agnostic wrapper around Reddit's rest API that handles retries, and Reddit's different response codes.

    In order to use the api head over to the Reddit API Documentation. All of the api methods use one of the 5 HTTP methods (GET, POST, PATCH, PUT, DELETE) which map to the 5 different redditAPI.api methods.

    // endpoint: api endpoint ex: 'api/v1/me' or '/api/v1/me/karma/' (listed on api documentation)
    // data: JSON data, dependent on the request which is specified in the docs
    // NOTE: the function .get is used for api calls that use HTTP GET, you can find the method each api endpiont uses on (you guessed it) the reddit api docs
    // HTTP GET
    redditWrapper.api.get(endpoint, data)
    .then(function(response) {
        let responseCode = response[0];
        let responseData = response[1];
        console.log("Received response (" + responseCode + "): ", responseData);
    .catch(function(err) {
        return console.error("api request failed: " + err)
    // HTTP POST, data)
    .then(function(response) {})
    .catch(function(err) {})
    redditWrapper.api.patch(endpoint, data)
    .then(function(response) {})
    .catch(function(err) {})
    // HTTP PUT
    redditWrapper.api.put(endpoint, data)
    .then(function(response) {})
    .catch(function(err) {})
    redditWrapper.api.delete(endpoint, data)
    .then(function(response) {})
    .catch(function(err) {})
    // gets an api token 
    .then(function(token) {})
    .catch(function(err) {})

    Note: new accounts get little to no posting privileges (1 comment or post per 5 minutes or more) if you dont have any karma. If you just want to play around with the api I recommend using an active account.

    Note: the response from any HTTP methods will be an array containing [responseCode, data].

    Note: Any 403 that occurs during a retry process will cause a token refresh and a endpoint retry.

    Basic API Usage

    check how much karma your bot has

    redditWrapper.api.get('api/v1/me/karma', {})
    .then(function(resp) {
        let responseCode = response[0];
        let responseData = response[1];
        console.log("I have " + responseData.karma + " karma")
    .catch(function(err) {
        console.log("Error getting karma: ", err);

    post a comment"/api/comment", {
        api_type: "json",
        text:     "Hello World"
    .then(function(resp) {
        let responseCode = response[0];
        let responseData = response[1];
        console.log("Posted comment!");
    .catch(function(err) {
        console.log("Error posting comment: ", err);

    Final Notes

    • This was largely based on the reddit-snooper library. However that is no longer maintained.
    • This relies on Bluebird promises.
    • Feel free to make feature requests, bugs, etc. I will try to be as prompt at fixing/getting back to you.


    npm i reddit-wrapper-v2

    DownloadsWeekly Downloads






    Unpacked Size

    36.1 kB

    Total Files


    Last publish


    • jmambrid