Logo
Reddit Logo

Reddit APIs

Reddit, stylized as reddit, is a social news and entertainment website where registered users submit content in the form of links or text posts.

Reddit APIs

Account Request URL

-

Base Endpoint

-

about

Get information about a subreddit

about/{subreddit}

access_token, include_over18, sort, limit, sr_detail

accept_moderator_invite

Accept a moderator invite

api/moderator_invite/{id}/accept

access_token

add_subreddit_topic

Add a topic to a subreddit

api/subreddit/{subreddit}/topic/{topic}

access_token

approve

Approve a post or comment

api/approve

access_token, id, spam

block

Block a user

api/block

access_token, account_id

clear_reports

Clear the report queue for a comment or post

api/clearreports

access_token, id

collapse

Collapse a comment thread

api/collapse

access_token, id

comment

Create a comment

api/comment

access_token, api_type, body, context, parent, thing_id

compose_message

Create a private message

api/compose

access_token, api_type, body, subject, to

configure_automoderator

Configure subreddit automoderator rules

api/automoderator/configure

access_token, css, description, kind, moderators, name, rules, stylesheet, wiki

configure_flair

Configure link flair for a subreddit

api/flairconfig

access_token, css_class, flair_template_id, link_flair_text, text

contest_mode

Enable contest mode for a post

api/contest_mode

access_token, id

convert_subreddit_type

Convert a link subreddit to a text subreddit or vice versa

api/convert_subreddit_type

access_token, type

create_comment

Create a comment

api/comment

access_token, api_type, body, context, parent, thing_id

create_link

Create a link post

api/submit

access_token, api_type, flair_id, kind, resubmit, sendreplies, spoiler, sr, title, url

create_message

Create a private message

api/compose

access_token, api_type, body, subject, to

create_poll

Create a poll that links to an external website

api/poll

access_token, choices, duration, link, options, subreddit, title

create_reddit_uploads_image

Upload an image to Reddit’s servers using the Reddit uploads API

https://{region}.redditmedia.com/api/upload/{subreddit_full_name}

access_token, filepath

create_subreddit

Create a subreddit

api/subreddit/create

access_token, description, name, public_description, title, type

create_user

Create a new user

api/register/

api_type, name, passwd1, passwd2, redirect_uri, username

create_widget

Create a widget

api/widget

access_token, css, data, description, display_name, kind, modhash

delete

Delete a link

comment

message

delete_flair

Delete link flair

api/flair

access_token, link, text

delete_message

Delete a message

api/del

access_token, id

delete_subreddit_topic

Remove a topic from a subreddit

api/subreddit/{subreddit}/topic/{topic}

access_token

delete_widget

Delete a widget

api/widget/{widget_id}

access_token

disable_inbox_replies

Disable inbox replies

api/me/disable_inbox_replies

access_token

disable_messages

Disable private messaging

api/disable_messages

access_token

distinguish

Distinguish an object

api/distinguish

access_token, how, id

downvote

Downvote a submission or comment

api/vote

access_token, dir, id

edit_comment

Edit a comment

api/editusertext

access_token, text, thing_id

edit_flair

Update a user's flair in a subreddit

api/flair

access_token, css_class, flair_template_id, link, text, user

edit_subreddit

Update a subreddit

api/subreddit_settings

access_token, allow_chat_post_creation, allow_discovery, allow_galleries, allow_images, allow_live_chat, allow_polls, allow_predictions, allow_videogifs, collapse_deleted_comments, comment_score_hide_mins, description, exclude_banned_modqueue, free_form_reports, header_title, hide_ads, lang, name, over18, public_description, require_post_flair, show_media, spam_links, spam_selfposts, submit_link_label, submit_text_label, title, type, wiki_edit_karma

edit_subreddit_stylesheets

Edit a subreddit style

api/subreddit_stylesheet

access_token, changes, subreddit, stylesheet_contents

edit_user_subreddit_preferences

Update user preferences for a subreddit

api/subreddit/{subreddit}/api_type/slow_mode

access_token, api_type, slow_mode

edit_wiki_page

Edit a wiki page

api/editwikipage

access_token, content, page, reason

enable_inbox_replies

Enable inbox replies

api/me/enable_inbox_replies

access_token

fullname

Get the fullnames of a listing of things

api/info

id, url

gild

Give someone gold

api/gold

access_token, days, name, thing_id

hide

Hide a submission or comment

api/hide

access_token, id

leave_moderator

Leave a mod position

api/leavemoderator

access_token, id

lock

Lock a post

api/lock

access_token, id

mark_nsfw

Mark a submission as NSFW

api/marknsfw

access_token, id

morechildren

Return more children of a comment

api/morechildren/{link_id}/{comment_id}/{children_depth}

link_id, children_depth, comment_id

mute_subreddit

Mute a subreddit

api/mute_subreddit

access_token, name

my_subreddits

Get a redditor's subscribed subreddits

api/subreddits/mine/subscriber

access_token

new_mod

Invite a new moderator to a subreddit

api/moderator/{subreddit}/invite

access_token, name

numping

Return comment count for submissions in a subreddit

api/numping/{subreddit}

subreddit

oauth_authorize

Authorize a client

https://www.reddit.com/api/v1/authorize

client_id, duration, redirect_uri, response_type, scope, state

oauth_token

Get an access token

https://www.reddit.com/api/v1/access_token

client_id, code, device_id, grant_type, redirect_uri, refresh_token, username, password

pin

Pin a post as the first post in a subreddit

api/pin

access_token, id

promote

Promote a comment to the top level of a post

api/promote

access_token, id

quarantine

Quarantine a subreddit

api/quarantine

access_token, id

random

Get a random subreddit

api/randomsubreddit/

access_token

remove

Remove an approved user in a subreddit

api/unmoderator

access_token, id

remove_subreddit_topic

Remove a topic from a subreddit

api/subreddit/{subreddit}/topic/{topic}

access_token

report

Report a submission

api/report

access_token, id, reason

revoke_moderator_invite

Revoke a moderator invite

api/moderator_invite/{id}/revoke

access_token

rules

Get the rules of a subreddit

api/rules/{subreddit}

access_token

save

Save a submission

api/save

access_token, category, id

search

Search Reddit

api/search/{sort}/{time period}/{subreddit}

q, sort, subreddit

select_flair

Select flair for a user in a subreddit

api/selectflair

access_token, css_class, flair_template_id, link, text, user

send_feedback

Send feedback to admins

api/feedback

access_token, body, thing_id

send_message

Send a private message

api/sendmessage

access_token, api_type, body, subject, to

set_flair

Set link flair for a post

api/flair

access_token, css_class, flair_template_id, link, text

set_subreddit_settings

Update a subreddit's settings

api/subreddit_settings

access_token, allow_chat_post_creation, allow_discovery, allow_

Details

Popular

Provider

Country HQ

API Type

REST

Categories

Social

Alternatives

Important URLs

Last Updated on

2024-04-03

Created At

2023-12-14

Other Apps

Upskill for a better future

Want to start tracking API at scale?

Get updates about your favorite APIs and SDKs

Contact Us

We do our best to ensure that the data we release is complete, accurate, and useful. However, because we are not able to verify all the data, and because the processing required to make the data useful is complex, we cannot be held liable for omissions or inaccuracies.

ApiRefs Logo