App Logo
reddit.com

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.

Input

queries required
subreddits required

Subreddit names without r/

sort optional
Default: "relevance"
time optional
Default: "year"
limit optional
Default: 25
bodyChars optional
Default: 600

Output

count optional
errors optional
threads optional

FAQ

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.
Required: subreddits, queries. Optional: sort, time, limit, bodyChars.
It returns count, errors, threads.
Yes. It acts as you on reddit.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the reddit.com cookies saved by the Reduck extension.
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_subreddit_threads, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/reddit.com/search_subreddit_threads
It is part of Reduck's official curated catalogue.

Related scripts

reddit.com

Get Reddit thread

Fetch a full Reddit thread from its URL. Returns title, op_text, score, num_comments, and comments (author, body, score, nesting depth). Compare num_comments to total_comments to detect truncation; use all_comments to expand every "more replies" thread automatically.

reddit.com

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.

reddit.com

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.

Start building not clicking

Get started for free