> ## 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.

# Search Reddit Tool

> Search Reddit posts and comments for specific topics and discussions

## What it does

The Search Reddit tool searches across Reddit posts and comments for specific topics. Perfect for market research, sentiment analysis, community insights, and understanding public opinion on various subjects.

## Key features

* Search across all of Reddit or filter by time periods
* Get post titles, content, scores, and comment counts
* Include top comments in results for deeper insights
* Configurable result limits to control data volume
* Access to post metadata like subreddit and engagement metrics

## Parameters

| Parameter          | Type    | Required | Description                                                                        |
| ------------------ | ------- | -------- | ---------------------------------------------------------------------------------- |
| `search_term`      | string  | Yes      | The term or phrase to search for on Reddit                                         |
| `time_filter`      | string  | No       | Time period filter: "all", "day", "hour", "month", "week", "year" (default: "all") |
| `limit`            | integer | No       | Number of posts to fetch (default: 10)                                             |
| `include_comments` | boolean | No       | Whether to include top comments (default: true)                                    |

## Common use cases

### Market research

```
search_term: "iPhone 15 review"
time_filter: "month"
limit: 20
include_comments: true
```

Research public opinion about products or services.

### Trend analysis

```
search_term: "remote work 2024"
time_filter: "week"
limit: 15
include_comments: true
```

Understand current trends and discussions.

### Competitive analysis

```
search_term: "best project management tools"
time_filter: "month"
limit: 25
include_comments: true
```

See what people are saying about competitors.

### Technical research

```
search_term: "Python vs JavaScript"
time_filter: "year"
limit: 30
include_comments: false
```

Research technical topics and developer opinions.

### Crisis monitoring

```
search_term: "company name outage"
time_filter: "day"
limit: 50
include_comments: true
```

Monitor mentions during incidents or crises.

### Content inspiration

```
search_term: "startup marketing strategies"
time_filter: "month"
limit: 20
include_comments: true
```

Find content ideas and community discussions.

## What you get back

* **Post Title**: The title of each Reddit post
* **Post Content**: Full text content of the post
* **Subreddit**: Which community the post was made in
* **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 search terms for better results
* Include time filters for recent discussions
* Enable comments for deeper insights
* Adjust limit based on your analysis needs
* Try different phrasings if initial results are limited
* Consider subreddit-specific searches for targeted research

## Troubleshooting

**"No results found"**

* Try broader or different search terms
* Remove time filters to search all time
* Check spelling and try alternative phrasings

**"Limited results"**

* Increase the limit parameter
* Use broader search terms
* Try different time filters

**"Search failed"**

* Verify internet connectivity
* Try simpler search terms
* Check if Reddit is accessible

## Related tools

* [Search Google](/tools/search_google) - Search the broader web
* [Read Subreddit](/tools/read_subreddit) - Get posts from specific subreddits
* [Search TikTok](/tools/search_tiktok) - Search TikTok for social media insights