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. 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
topic requiredSearch query
sort optionalReddit's native sort (default relevance)
Default: "relevance"time optionalReddit's native time filter (default all). Ignored by Reddit when sort=new.
Default: "all"limit optionalMax results, paginating via the site's own infinite scroll (default 25)
Default: 25Output
count requiredthreads requiredFAQ
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.
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.
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.
