Get Reddit home feed
Automatically get Reddit home feed on reddit.com. Get the signed-in account's own Reddit home feed (reddit.com/?feed=home), one page at a time — its mix of subscribed communities and Reddit's recommendations, in the order the feed serves them, promoted slots included. Not r/popular: use get_trending for the cross-Reddit trending feed. Returns per item id, url, title, subreddit, author, created, score, num_comments, upvote_ratio, post_type, content_href, body, plus is_subscribed (the post comes from a community you joined, as opposed to a recommendation) and is_promoted (an ad slot). An ad carries no subreddit, since it is posted from a user profile rather than a community. sort takes the feed's own five orders; time is Reddit's window on the top sort. Each call returns one page as Reddit serves it (its size is Reddit's) and a nextCursor: pass it as cursor, with the same sort and time, for the next page; it is null when the feed has no more.
Input
sort optionalThe feed's own sort, as the home page's sort control exposes it. Default best, which is Reddit's own default.
Default: "best"time optionalTime window for the top sort (Reddit applies it to top only, and defaults to day when omitted). Ignored by the other sorts.
cursor optionalThe nextCursor of the previous answer, to read the next page. Omit for the first page. Pass the same sort and time as for the first page.
Output
count requiredNumber of items on this page.
posts requirednextCursor requiredPass as cursor to read the next page; null when the feed has no next page.
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.
