Official scripts
Explore our curated collection of scripts
Get Reddit user comments
Fetch a Reddit user's recent comments from their profile Comments tab (with or without u/ prefix). Returns subreddit, post title/url, comment body/permalink, score, timestamp, and stickied flag. Scrolls to load more when limit exceeds one page.
Join subreddit
Join (subscribe to) a subreddit by name. If you're already a member, nothing changes and changed is returned as false. Runs only via the browser extension, not the hosted cloud browser.
Save Reddit post
Save a Reddit post to your saved list by its URL. If it's already saved, nothing changes and changed is returned as false. Saving is private (visible only in your own saved list). Runs only via the browser extension, not the hosted cloud browser.
Submit Reddit post
Create a text post (thread) in a subreddit. Returns the new post's ID, subreddit and URL. Posts a real thread under the logged-in account; text posts only (no link/image); some subreddits require a flair and will block the post. Runs only via the browser extension, not the hosted cloud browser.
Reddit login (emailed one-time link via Gmail)
Sign in to Reddit without a password: requests Reddit's emailed one-time login link for the given address, opens it from that address's Gmail inbox in the same browser, and lands signed in. Returns straight away if already signed in, and reports the Reddit username. The Gmail account for that address must be signed in on this browser.
Search a subreddit
Search posts within a single subreddit, with optional sort, time window, and date cutoff. Returns subreddit, count, and threads (each with id, url, title, author, score, num_comments, created, subreddit, nsfw, preview_text). `limit` is a maximum, not a guarantee: a search with fewer matches returns what exists, and a search with none returns count 0. With `sort=new`, pass `since` (an ISO date or shorthand like "7d") to leave out results older than that cutoff. When a query has no genuine matches, Reddit's own search sometimes returns a few loosely related posts from the subreddit instead of an empty result, with no way to tell them apart from real hits. Reddit's subreddit-scoped search cards show titles only, so preview_text is null here; for body excerpts use reddit.com/search_reddit with a `subreddit:name` term in the query.
Reddit unofficial API: read the full moderator list of subreddits
Returns the complete moderator list of each subreddit you ask for — every moderator, not just the first screen the mod page shows — with each one's permissions. Also reports, per moderator, which of the requested subreddits they moderate, so you can see who sits on several communities at once and how much their mod teams overlap.
Post Reddit comment
Post a top-level comment on a Reddit post by its URL. Returns the created comment's id, permalink, author, created timestamp and score. Posts a real comment under the logged-in account; this is a top-level comment on the post, not a reply to another comment. Runs only via the browser extension, not the hosted cloud browser.
Get Reddit thread
Fetch a Reddit thread by its id or URL: the post (title, text, author, score, upvote ratio, comment count, type, link) and its comments in thread order, each with author, text, score, date, permalink and nesting depth. Needs a browser signed in to Reddit. By default it returns the first page of comments Reddit shows when the thread opens; set all_comments to expand every "more replies" and get the whole tree. num_comments counts deleted and removed comments too, so the list can be shorter than that number even when it is complete. sort picks Reddit's own comment order (best, top, new, controversial, old, Q&A).
Get Reddit user profile
Fetch a Reddit user's profile by their username (with or without the u/ prefix). Returns username, display_name, description, karma, contributions, reddit_age, and recent posts and comments (type, title, text, subreddit, score, created, url).
Search Reddit
Search posts across all of Reddit (no subreddit restriction), with optional sort and time window. Returns count and threads (each with id, url, title, author, subreddit, score, num_comments, created, nsfw, preview_text). `limit` is a maximum: fewer matching posts than requested returns however many exist. Useful to discover which subreddits discuss a topic. The sort changes how relevant the results are: `top` orders Reddit's matches by score, and because Reddit matches loosely, a heavily upvoted post only tangentially related to the query can outrank the genuine matches. That is Reddit's own ranking, returned as-is. Use the default `relevance` sort when on-topic results matter, and treat a non-zero count under `top` as "Reddit returned something", not as proof the posts are about the topic. Reddit refuses connections from datacenter addresses, so this works as-is on your own browser; on a hosted cloud browser the session has to be given a country so it exits through a residential address, otherwise Reddit blocks it and the script says so.
Get trending Reddit posts
List Reddit's trending threads from r/popular, with optional sort. Returns id, url, title, subreddit, author, score, comment count, date, post type and the post's text per thread. limit is a maximum: fewer come back when the feed stops serving.
Edit Reddit post
Edit the body of your own Reddit text post by its URL, replacing it entirely. Returns edited and postId. Text posts only (the title can't be edited on Reddit); only works on your own posts. Runs only via the browser extension, not the hosted cloud browser.
Get subreddit threads
List a subreddit's threads by Reddit's native sort (best/hot/new/top/rising). "new" is chronological (filter with `since`); "top" takes a `time` window (hour…all); others paginate by `limit`. Returns url, title, author, score, num_comments, created, post_type, and body — the post's full text (never truncated; null for link/image posts). `limit` is a maximum, not a guarantee: fewer matching threads returns what exists.
Search Reddit threads across several subreddits with a list of queries
Run several search queries across one or more subreddits in a single pass and get back the matching threads, deduplicated across queries and subreddits: title, subreddit, permalink, upvotes, comment count, creation date, flair, and the opening of the post body. Each thread also lists which of your queries matched it, and results are ordered by how many queries matched, then by upvotes. Sort and time window are configurable, and any query that a subreddit refuses is reported separately instead of failing the whole run.
Reply to Reddit comment
Reply to a Reddit comment at any nesting depth, by its permalink. Returns the new reply's id, permalink, author and depth. Posts a real, public reply under the logged-in account. Runs only via the browser extension, not the hosted cloud browser.
Vote on Reddit post or comment
Up, down, or clear your vote on a Reddit post or comment by its URL/permalink. Safe to repeat: it only changes the vote if it isn't already in the requested state. You cannot downvote or clear the vote on your own post, since Reddit forces the author's upvote and the change reverts on reload. Runs only via the browser extension, not the hosted cloud browser.
Get subreddit info
Fetch a subreddit's metadata: title, description, created date, weekly visitors and contributions, its type (public, restricted…), every rule (title and body), and its full moderator list with each moderator's permissions and join date. A banned or private subreddit returns its status and nothing else; an unknown name throws. The moderator list is null when Reddit does not show it to the browser's session.
Unsave Reddit post
Remove a Reddit post from your saved list by its URL. If it wasn't saved, nothing changes and changed is returned as false. Runs only via the browser extension, not the hosted cloud browser.
Send Reddit DM
Send a Reddit direct message to a user. Returns sent and recipient. A subject is required by Reddit but won't appear in the conversation. Fails for recipients who don't accept DMs. Runs only via the browser extension, not the hosted cloud browser.
Leave subreddit
Leave (unsubscribe from) a subreddit by name. If you're not a member, nothing changes and changed is returned as false. Runs only via the browser extension, not the hosted cloud browser.
Delete Reddit comment
Delete your own Reddit comment (at any depth) by its permalink. Returns deleted and commentId. This is irreversible, only works on your own comments, and replies to it remain visible under [deleted]. Runs only via the browser extension, not the hosted cloud browser.
Delete Reddit post
Delete your own Reddit post by its URL. Returns deleted and postId. This is irreversible and only works on your own posts. Runs only via the browser extension, not the hosted cloud browser.
Follow Reddit user
Follow a Reddit user by username. If you already follow them, nothing changes and changed is returned as false. Runs only via the browser extension, not the hosted cloud browser.
Who am I on Reddit
Report which Reddit account the browser is signed in as: the username (the u/ handle every other Reddit script takes as an argument) and the profile display name, which a redditor can set to something different. Throws when signed out. Runs only via the browser extension, not the hosted cloud browser.