Overview

Reddit API covers posts, comments, subreddits, user data, voting. The Automize Reddit connector covers these endpoints.

Regions: Global.
Plans: Free for noncommercial. Commercial use requires Enterprise tier (paid, since 2023).

Setting up the connection

Auth type: OAuth 2.0 (Authorization Code).

Reddit → My Apps → create script/web app.
OAuth client ID + secret.
In Automize → Settings → Connectors → Reddit. Paste credentials. User agent string required.

Find your credentials at https://www.reddit.com/prefs/apps.

Rate limits

60 req/min OAuth. Commercial tier higher.

Data model

Reddit primitives:

    User ─── Subreddits (subscribed)
    Subreddit ─── Posts ─── Comments
              ├─ Mod queue
              └─ Wiki

Available operations

8 operations available. Click any row to jump to its detail.

Operation	Category	What it does
Add Comment	General	Add a comment to a post or reply
Get Current User	General	Get the authenticated user profile
Get Post	General	Get a post and its comments
Get Subreddit	General	Get subreddit information
List Posts	General	List posts in a subreddit by sort order
Search	General	Search Reddit posts
Submit Post	General	Submit a new post to a subreddit
Vote	General	Upvote, downvote or unvote a post

Operations

Add Comment

Add a comment to a post or reply

Parameter	Required	Type	Description
Parent `parent`	Yes	text
Text `text`	Yes	text

Get Current User

Get the authenticated user profile

No input parameters.

Get Post

Get a post and its comments

Parameter	Required	Type	Description
Post Id `post_id`	Yes	text

Get Subreddit

Get subreddit information

Parameter	Required	Type	Description
Subreddit `subreddit`	Yes	text

List Posts

List posts in a subreddit by sort order

Parameter	Required	Type	Description
Subreddit `subreddit`	Yes	text
Sort `sort`	No	select	Listing order. `new` is the one to use for unanswered threads; `hot` is Reddit's own default.
Time window `t`	No	select	Only applies to the `top` and `controversial` sorts. Reddit ignores it otherwise.

Tips

Per subreddit. Sort: hot (default), new, top, rising, controversial.
Use `new` to find threads nobody has answered yet; `hot` is Reddit's own default ordering.
Time window only applies to `top` and `controversial` – Reddit ignores it on the other sorts.

Search

Search Reddit posts

No input parameters.

Submit Post

Submit a new post to a subreddit

Parameter	Required	Type
Sr `sr`	Yes	text
Kind `kind`	Yes	text
Title `title`	Yes	text
Text `text`	Yes	text
Url `url`	Yes	text

Vote

Upvote, downvote or unvote a post

Parameter	Required	Type	Description
Id `id`	Yes	text
Dir `dir`	Yes	text