Submit Reddit post
Input
body requiredPost body text (plain text / markdown). Supports inline @-mentions (u/name — Reddit auto-links them) and links; inline images/banners are not supported (would require a file upload, CLI-only).
title requiredPost title
subreddit requiredTarget subreddit, with or without r/ prefix
Output
url requiredpostId requiredFullname of the created post, e.g. t3_xxxxx
posted requiredsubreddit requiredaccount_used requiredThe real logged-in Reddit handle that performed the action, read from the page's own account drawer (not assumed from args)
already_present requiredWhether an identical-title post by this account already existed in the subreddit before publishing (checked via the account's own submitted-posts list)
verified_on_page requiredWhether the script reloaded the created post's own page afterward and confirmed it's actually visible there with the right title and author
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.
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.