Set Reddit post flair
Automatically set Reddit post flair on reddit.com. Set or remove the flair on your own Reddit post, by its URL. Picks a matching flair template from the subreddit's own list (filtered by name) and, if the template allows custom text, sets that text; passing an empty flairText removes any existing flair. Returns the flair actually applied, read back from the post. Fails loudly if the subreddit has flair disabled for posts, or if no template matches the requested name.
Input
postUrl requiredURL of the Reddit post to flair (yours, or one you moderate)
flairText optionalFlair text to apply, matched against the subreddit's flair templates. Omit or pass an empty string to remove the post's current flair.
Output
applied requiredpostUrl requiredflairText optionalverifiedFlair optionalThe flair text read back from the post after applying, or null if no flair is set
FAQ
Get Reddit thread
Fetch a Reddit thread by its id or URL: the post (title, text, author, score, upvote ratio, comment count, type, link) and its comments in thread order, each with author, text, score, date, permalink and nesting depth. Needs a browser signed in to Reddit. By default it returns the first page of comments Reddit shows when the thread opens; set all_comments to expand every "more replies" and get the whole tree. num_comments counts deleted and removed comments too, so the list can be shorter than that number even when it is complete. sort picks Reddit's own comment order (best, top, new, controversial, old, Q&A).
Get Reddit 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, with Reddit's own sort and time window. Returns count and threads (id, url, title, author, subreddit, score, num_comments, created, nsfw, preview_text) in the order Reddit lists them. `limit` is a maximum: fewer matching posts return what exists, and no match returns count 0. Reddit matches loosely, so under the `top` sort a heavily upvoted post only loosely related to the query can come before closer matches; use the default `relevance` sort when on-topic results matter.
