App Logo
reddit.com

Search a Reddit subreddit

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

Input

topic required

Search query

subreddit required

Subreddit name, with or without the r/ prefix

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"
cursor optional

The nextCursor of the previous answer, to read the next page. Omit for the first page. Pass the same subreddit, topic, sort and time as for the first page.

Output

count required
threads required
subreddit required
nextCursor required

Pass as cursor to read the next page; null on the last page.

FAQ

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.
Ask an AI agent connected to Reduck to run reduck/reddit.com/search_subreddit, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/reddit.com/search_subreddit
You do not need one. "Search a Reddit subreddit" drives the real reddit.com pages in a browser, so it works whether or not reddit.com offers an API for this.
Required: subreddit, topic. Optional: sort, time, cursor.
It returns count, threads, subreddit, nextCursor.
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_subreddit, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/reddit.com/search_subreddit
It is part of Reduck's official curated catalogue.

Start building not clicking