List a community's posts: hot, new, rising, top, or controversial
A community's own listing, with no keyword: everything new in r/saas, or this week's top posts in r/startups. Use this rather than search when the community is the filter — Reddit's search needs a query and cannot express "everything".
name also takes popular, all, or several communities joined with +, which reads them as one listing in a single call (and is billed as one request).
Pages are newest-cursor-forward and stop at about 1,000 posts, Reddit's own ceiling, where nextCursor becomes null. NSFW posts are left out unless includeNsfw=true; how many were left out is in meta.omittedNsfw. A community that does not exist, or is private, banned, or quarantined, is a 404 whose details.reason says which.
Request
- Base URL: https://api.weirapp.io
- URL: https://api.weirapp.io/v1/reddit/subreddits/{name}/posts
- Auth: HTTP bearer
Path parameters
A community name without r/; popular or all for the site-wide listings; or up to 25 communities joined with + (saas+startups+entrepreneur) to read them as one listing in a single call.
Query parameters
Reddit's own orderings. new is arrival order, which is what watching a community needs; hot is Reddit's default front page.
Window for top and controversial only. Defaults to day for those sorts.
Region for popular sorted by hot only: a country code (DE), a US state (US_CA), or GLOBAL.
Include posts marked NSFW. Off by default; what it removes is reported in meta.omittedNsfw, so a short or empty page is never mistaken for a quiet one.
Posts per page, before the NSFW rule is applied.
meta.nextCursor from the previous page, unchanged. Opaque, signed, and bound to the other parameters: change any of them and start again without a cursor.
Response
Posts in the listing's order, in Reddit's own field names.
Changes
No recorded changes to this operation across all 1 revision of this API.