App Logo
reddit.com

Search Reddit

Automatically search Reddit on reddit.com. 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.

Input

sort optional

Reddit's native sort (default relevance)

Default: "relevance"
time optional

Reddit's native time filter (default all). Ignored by Reddit when sort=new.

Default: "all"
limit optional

Max results, paginating via the site's own infinite scroll (default 25)

Default: 25
query optional

Alias for `topic` (accepted for compatibility — prefer `topic`).

topic optional

Search query. Canonical name for this field; `query` is accepted as an alias.

queries optional

Not supported since 19 Oct 2026: the run fails with a message saying so. Send one topic per call and fan out with run_script's scripts.

Output

count required
threads required

FAQ

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.
Ask an AI agent connected to Reduck to run reduck/reddit.com/search_reddit, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/reddit.com/search_reddit
You do not need one. "Search Reddit" drives the real reddit.com pages in a browser, so it works whether or not reddit.com offers an API for this.
Optional: sort, time, limit, query, topic, queries.
It returns count, threads.
No. It only uses pages of reddit.com that are reachable without signing in.
It only reads. It looks things up on reddit.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/reddit.com/search_reddit, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/reddit.com/search_reddit
It is part of Reduck's official curated catalogue.

Related scripts

reddit.com

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).

reddit.com

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.

reddit.com

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.

Start building not clicking

Get started for free