App Logo
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.

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.

Output

count required
threads required

FAQ

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.
Optional: sort, time, limit, query, topic.
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 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

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.

reddit.com

Get subreddit info

Fetch a subreddit's metadata from its page: title, description, weekly active users / contributions, created date, visibility, rules (title + body), and the full moderator list (username, permissions, joined). Banned/private subs return status with detail; unknown subs throw.

Start building not clicking

Get started for free