Get Reddit subreddit threads
Input
sort optionalReddit's native subreddit sort. "new" is chronological (supports `since`); best/hot/top/rising are ranked (use `limit`). Default new.
Default: "new"time optionalTime window for sort:"top" only (default all). Rejected for other sorts.
limit optionalMax number of threads to return (newest first). With `since` and no `limit`, the time window is the only bound: every post in it is returned. With neither, 25. A maximum, not a guarantee: fewer matching threads returns what exists.
since optionalsort:"new" only - how far back to go: ISO date ("2026-06-01") or shorthand ("24h", "7d", "2w"). Combine with `limit` to cap a time window.
subreddit optionalSubreddit name, with or without the r/ prefix. Case-insensitive: Reddit redirects to the canonical casing (r/python -> r/Python) and the script follows it.
subreddits optionalNot supported since 19 Oct 2026: the run fails with a message saying so. Send one subreddit per call and fan out with run_script's scripts.
Output
count optionalthreads optionalcomplete optionaltrue when the feed (or the `since` window) ended before `limit` was reached, so every thread it holds is here; false when `limit` stopped the read and more threads exist.
subreddit optionalFAQ
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.
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.