Browse a subreddit
browse_subredditList a subreddit's hot, new, top, rising, or controversial posts by time window, combine multiple communities, and paginate results for Reddit research.
Instructions
List a subreddit's posts: hot, new, top, rising or controversial.
Use listing="top" with time="year" or "all" to find a community's most valued posts, and "new" for the latest. Combine communities with "a+b" (at most 50) to read several in one call. To look for a topic inside a community, use search_reddit(subreddit=...) instead. Each result starts with [id] for get_post / get_posts. Output is capped near 50,000 characters; the last line gives the cursor for the next page.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"subreddit": "<subreddit>"
},
"name": "browse_subreddit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | No | Time window; applies to top and controversial only. | week |
| after | No | Cursor from a previous 'next: after=...' line. | |
| limit | No | Posts per page, 1 to 100. | |
| listing | No | hot (default), new (latest), top (most upvoted in `time`), rising (gaining votes now) or controversial (divided votes in `time`). | hot |
| subreddit | Yes | Subreddit name ("dataengineering", "r/x" is fine) or several joined with + ("a+b"). | |
| body_chars | No | Characters of each post body to show, 0 to 4000. | |
| include_nsfw | No | Show posts, comments and communities Reddit marks NSFW (18+). Off by default; hidden items are counted in the output. A server setting can keep them hidden even when true. |