Official scripts
Explore our curated collection of scripts
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.
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.
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.
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.
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.
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.
Search a Reddit subreddit
Search posts within a single subreddit, with optional sort and time window, one page at a time. Returns subreddit, count, threads (each with id, url, title, author, score, num_comments, created, subreddit, nsfw, preview_text) and nextCursor: pass it as cursor, with the same subreddit, topic, sort and time, for the next page; it is null on the last page. A search with no matches returns count 0. Reddit ignores `time` when sort=new. 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.
Get Reddit 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.
Get Reddit 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.
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).
Search Reddit
Search posts across all of Reddit, with Reddit's own sort and time window. Returns count and threads (id, url, title, author, subreddit, score, num_comments, created, nsfw, preview_text) in the order Reddit lists them. `limit` is a maximum: fewer matching posts return what exists, and no match returns count 0. Reddit matches loosely, so under the `top` sort a heavily upvoted post only loosely related to the query can come before closer matches; use the default `relevance` sort when on-topic results matter.
Search Reddit threads in a subreddit, with post text
Search one subreddit for a query and get one page of matching threads in Reddit's order, each with title, subreddit, permalink, upvotes, comment count, creation time, flair and the post's full text. Sort and time window are configurable; pass the returned after value to read the next page (null on the last one). Requires being signed in to Reddit. A subreddit that refuses the search (private, banned) fails with its HTTP status. To search several subreddits or queries, run the script once per pair.
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.
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.
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.
Get trending Reddit posts
List Reddit's trending threads from r/popular, one page at a time, with optional sort. Returns id, url, title, subreddit, author, score, comment count, date, post type and the post's text per thread. Each call returns one page as Reddit serves it (the first page can be short, a few threads) and a nextCursor: pass it as cursor, with the same sort, for the next page; it is null when the feed has no more.
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.
Get Reddit user comments
Fetch a Reddit user's recent comments from their profile Comments tab (with or without u/ prefix), one page at a time, newest first. Returns subreddit, post title/url, comment body/permalink, score, timestamp, and stickied flag. A profile with no comments returns an empty list; an unknown user fails. Pass the returned nextCursor as cursor to read the next page; it is null on the last page.
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.
Get Reddit home feed
Get the signed-in account's own Reddit home feed (reddit.com/?feed=home), one page at a time — its mix of subscribed communities and Reddit's recommendations, in the order the feed serves them, promoted slots included. Not r/popular: use get_trending for the cross-Reddit trending feed. Returns per item id, url, title, subreddit, author, created, score, num_comments, upvote_ratio, post_type, content_href, body, plus is_subscribed (the post comes from a community you joined, as opposed to a recommendation) and is_promoted (an ad slot). An ad carries no subreddit, since it is posted from a user profile rather than a community. sort takes the feed's own five orders; time is Reddit's window on the top sort. Each call returns one page as Reddit serves it (its size is Reddit's) and a nextCursor: pass it as cursor, with the same sort and time, for the next page; it is null when the feed has no more.
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.
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.
Capture a page as a PNG
Screenshot any URL (not limited to Reddit) at a pinned viewport width and pixel density, and save it to the machine's Downloads folder as a real browser download. Runs signed in when the target host has a session, so Reddit captures have no cookie banner and no logged-out login panel. fullPage:true captures the whole scrollable page for assets that need scrolling; pass clipHeight to bound a very long page. Returns the filename, size in bytes, image width and height, and the page title. Confirmed on reddit.com: capturing while signed OUT triggers Reddit's bot detection (tab gets detached non-deterministically); once the device is actually logged into Reddit, both fullPage and viewport-only captures are clean.