Subreddit Posts

Fetches posts from a subreddit with sorting and filtering options. Each post includes title, author, link_flair_text when Reddit exposes it, selftext, score, ups, upvote_ratio, num_comments, created_utc, url, permalink, subreddit_subscribers, and is_video. Supports sort (best, hot, new, top, rising), timeframe filtering, pagination via the after token, and a trim parameter for lighter responses.

get/v1/reddit/subreddit

Query parameters

subredditstring required

Subreddit name

timeframe'all' | 'day' | 'week' | 'month' | 'year'

Timeframe to get posts from

sort'best' | 'hot' | 'new' | 'top' | 'rising'

Sort order

afterstring

After to get more posts. Get 'after' from previous response.

trimboolean

Set to true for a trimmed down version of the response

cache_max_age'1d' | '3d' | '7d' | '14d' | '30d'

If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details.

Response

Successful response

Changes

No recorded changes to this endpoint across all 1 revision of this API.