Subreddit
listSubreddit(sub, options?): Listing<Post>
Lists a subreddit's posts with their scores, comment counts, links and text. Pass a post's id to Post to read its comments. 1 credit per page of up to 100 posts; see Listings and pages for paging and NSFW filtering.
Security
API Key
All requests require a valid API key from the developer dashboard.
Headers: Authorization: Bearer YOUR_API_KEYorX-API-Key: YOUR_API_KEY
See Authentication for headers and rate limits.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
subquery | string | Yes | Subreddit name, with or without |
sortquery | string | No |
|
tquery | string | No | Time window for |
limitquery | integer | No | Posts per page, 1 to 100. Default |
afterquery | string | No | The previous page's |
nsfwquery | boolean | No | Include NSFW posts. Default |
Response
{
"subreddit": "golang",
"query": null,
"sort": "top",
"count": 3,
"items": [
{
"id": "1wysilc",
"name": "t3_1wysilc",
"subreddit": "golang",
"title": "Does our expertise still matter?",
"author": "evelve211",
"score": 242,
"upvote_ratio": 0.94,
"num_comments": 190,
"url": "https://www.reddit.com/r/golang/comments/1wysilc/does_our_expertise_still_matter/",
"permalink": "/r/golang/comments/1wysilc/does_our_expertise_still_matter/",
"domain": "self.golang",
"selftext": "Hello everyone, I'm writing this post in relation to AI and programming…",
"created_at": "2026-10-06T03:34:41Z",
"is_self": true,
"is_video": false,
"over_18": false,
"spoiler": false,
"stickied": false,
"locked": false,
"removed": false
}
],
"after": "t3_1x0vbyx",
"filtered_nsfw": 0
}url is where the post links: the post itself for a text post, or the shared page for a link post (domain tells them apart). selftext is the full text of a text post, empty for a link post. removed is true when the post was taken down by moderators or Reddit, or deleted by its author.