> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Read Subreddit Tool

> Get posts from specific Reddit communities with filtering and sorting options

## What it does

The Read Subreddit tool fetches posts from specific Reddit communities (subreddits). Perfect for monitoring specific communities, analyzing niche discussions, and gathering targeted content from particular interest groups.

## Key features

* Access posts from any public subreddit
* Sort by top, new, hot, or controversial posts
* Filter by time periods (hour, day, week, month, year, all time)
* Include top comments for deeper community insights
* Configurable post limits to control data volume

## Parameters

| Parameter          | Type    | Required | Description                                                                  |
| ------------------ | ------- | -------- | ---------------------------------------------------------------------------- |
| `subreddit`        | string  | Yes      | Name of the subreddit (without "r/")                                         |
| `item_type`        | string  | No       | Sort type: "top", "new", "controversial", "hot" (default: "top")             |
| `time_filter`      | string  | No       | Time period: "all", "day", "hour", "month", "week", "year" (default: "week") |
| `limit`            | integer | No       | Number of posts to fetch (default: 10)                                       |
| `include_comments` | boolean | No       | Whether to include top comments (default: true)                              |

## Common use cases

### Monitor industry discussions

```
subreddit: "programming"
item_type: "hot"
time_filter: "day"
limit: 20
include_comments: true
```

Stay updated on current programming discussions and trends.

### Research product feedback

```
subreddit: "apple"
item_type: "top"
time_filter: "week"
limit: 15
include_comments: true
```

See what users are saying about Apple products.

### Track community sentiment

```
subreddit: "cryptocurrency"
item_type: "controversial"
time_filter: "day"
limit: 25
include_comments: true
```

Monitor controversial topics and community debates.

### Content research

```
subreddit: "marketing"
item_type: "top"
time_filter: "month"
limit: 30
include_comments: false
```

Find popular marketing content and strategies.

### Competitive analysis

```
subreddit: "SaaS"
item_type: "new"
time_filter: "week"
limit: 20
include_comments: true
```

Monitor discussions about SaaS products and competitors.

### News and updates

```
subreddit: "technology"
item_type: "hot"
time_filter: "day"
limit: 15
include_comments: true
```

Get the latest technology news and community reactions.

## Sort types explained

* **Top**: Most upvoted posts in the time period
* **Hot**: Currently trending posts with high engagement
* **New**: Most recently posted content
* **Controversial**: Posts with high engagement but mixed votes

## What you get back

* **Post Title**: The title of each Reddit post
* **Post Content**: Full text content of the post
* **Score**: Upvotes minus downvotes
* **Comment Count**: Number of comments on the post
* **Top Comments**: Most upvoted comments (if enabled)
* **Post URL**: Direct link to the Reddit post

## Best practices

* Use specific subreddits for targeted insights
* Combine different sort types for comprehensive analysis
* Adjust time filters based on community activity levels
* Include comments for deeper community understanding
* Monitor multiple related subreddits for broader coverage
* Use "hot" for current trends, "top" for quality content

## Troubleshooting

**"Subreddit not found"**

* Check the subreddit name spelling
* Ensure the subreddit exists and is public
* Don't include "r/" in the subreddit name

**"No posts found"**

* Try different time filters (some communities are less active)
* Check if the subreddit has recent activity
* Try different sort types

**"Access denied"**

* The subreddit might be private or restricted
* Some subreddits require membership to view
* Try similar public subreddits instead

## Related tools

* [Search Reddit](/tools/search_reddit) - Search across all of Reddit
* [Search TikTok](/tools/search_tiktok) - Monitor TikTok discussions
* [Search Google](/tools/search_google) - Get broader web discussions